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contributors who use Archive, Ea 

sel and Abacus, as itis very easy for 
those of us who do a fair amount of writing 
to think only in terms of wordprocessors. | 
use a spreadsheet or database only occa- 
sionally, whereas it is a rare day when | 
don't use one or more wordprocessors. No 
doubt the statistics show that the majority 
of office and home micros excepting those 
designed solely for games-playing - are 
employed only for text work, like glorified 
typewriters. Nevertheless, integrated soft- 
ware packages always include modules for 
the other functions. 

The trouble with Archive and, to a lesser 
extent, Abacus, is that they are harder for 
the average user to get to grips with than 
Quill is. The same can be said of similar 
programs. You may want only to create a 
name and address list, but are put off by the 
formalities you have to go through to get the 


| T is just as well that there are some 


|job done. FlashBack made such jobs much 


easier, but it was effectively abandoned 
before it had been developed fully. Trying 
to explain to someone who has never used 
a computer before why it is necessary to 
have Fields, Records, Variables and so on 
is no easy task. In attempting to do this 
recently, | had to make it clear that what 
was being explained was the conventional 
view of constructing a database, not my 
own way of handling a list of addresses. 


Using Ascii 


Mainly because there seemed no other 
straightforward way of doing it, the transfer 
of my two FlashBack databases from QL to 
PC was done as a simple Ascii text file toa 
wordprocessor. No structure to bother about 
- just a bunch of fields within records, which 
ended up as individual paragraphs in the 
wordprocessor program. That was a year 
or two back, and the files still sit in the same 
wordprocessor program; there has been 
nothing to convince me that they ought to 
be re-created as ‘proper’ databases. 

The only reason this approach can be 
successful is speed. The wordprocessor 
has to work fast enough to allow scanning 
through the databases at a pace which 
does not cause annoyance. My files are not 
large ones (about 60 and 120 KB). At the 
time the transfer was made, my PC was 
effectively much faster than the QL, 
but things have changed drastically 
since then. The Gold Card and Per- 
fection have made the same exercise 
sensible on the QL. Digital Precision 


In a world where 
upgrades are nor- 
mal, we can always 
think of something 
else, says Bryan 
Davies. 


keep records as Perfection files, not 
because they won't use programs from 
other suppliers but because it is the sim- 
plest and fastest way of handling the data. 
Nevertheless, some of us will still hanker 
for a program with the flexibility of 
wordprocessor but with part of the formal 
structure possessed by database pro- 
grams. What this may mean is a combina- 
tion of FlashBack features with those of 
Perfection or text87. 

Taking a look at software for other com- 
puters, we can see database programs 
which allow data from the same file to be 
presented in several, visually-different 
forms, including those normally associ- 
ated with spreadsheet and business 
graphics programs. One such that | have 
used for some years allows the screen to 
be split into four areas, one showing indi- 
vidual records in a top-to-bottom layout, as 
in Archive, another presenting groups of 
records in a linear, side-to-side fashion, a 
third displaying X and Y axes and several 
graphs plotted from the same data, and 
the fourth giving a boxed display some- 
what like a spreadsheet, with cross-tabu- 
lated data. Thatlastis a bitesoteric, maybe, 
although it can present a quite new per- 
spective on sets of figures. Note that the 
discussion has gone from alpha to nu- 
meric data; there is no real reason why the 
same program cannot handle normal al- 
phanumeric records, such as names and 
addresses, as well as doing calculations 
onthe numeric data from the records. You 
can use Abacus for text preparation as 
well as for figure work. 

Having gotall the data, and the capability 
of manipulating it, why not permit reports 
to be printed out in a really presentable 
manner? ‘Presentation Graphics’ has an 
air of flash about it, but there are advan- 
tages to be gained from printed matter that 
uses some graphics (maybe only a logo). 

We have had some very comprehensive 
and good developments in wordprocessor 
for the QL recently. What | am asking is 
‘can we now have some _ non- 
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wordprocessor functions added?’ A little 
bit of FlashBack’s ease of handling records, 
some of Professional Publishers graph- 
ics-import capability, simple formulae as 
in Abacus, the typestyle handling of text87, 
and the general manipulative ability of 
Perfection. All rolled into one. Not much to 
ask, is it? Yes, we do need improved 
graphics to display it all, but the hardware 
stalwarts Up North are already working on 
that... 


What is speed? 


Arecent article and advert may have led 
to some confusion, and amusement, 
among wordprocessor buffs. Is it really 
sensible to make speed comparisons be- 
tween wordprocessor programs? Many 
people would want to see a straight ‘no’ 
answer to that question, but it really isn’t 
that simple, is it? How accurate and valid 
can such comparisons be? Quill is so slow 
performing certain operations that any 
would-be competitor has to be able to 
show that it is very much faster. It wouldn’t 
do to say a Copy operation takes half a day 
instead of a whole one - users want 
something better. With the current stand- 
ards, any normal wordprocessor operation 
that takes minutes is too slow. 

Forinstance, The Editoris quite aspeedy 
program - until you use it in Document 
Mode, when it becomes much slower. 
Where possible, any documents used 
during comparison checking need to be 
typical of what significant numbers of us- 
ers generate, and in the native format of 
the program under test. If quoting times 
taken to load Quill files into other pro- 
grams, remember that this is generally an 
infrequent one-shot operation and, from 
there on, the imported file will be used in 
the format of the new program, so any 
speed checks should be made in that 
format. 

We all have a threshold, below which 
improvements don’t get noticed. My own, 
in connection with program functions, 
seems to be around 25%, but only when 
the time taken is appreciable. A block 
operation that takes 15 seconds instead of 
20 is likely to seem faster to me. Whether 
or not one that takes 7.5 seconds as 
opposed to 10 will be noticed is another 
matter, and the chances of noticing 3 
seconds rather than 4 are not good. At 
levels of less than 10 seconds, itis unlikely 
that most users will be impressed, unless 
an improvementis, say, 50% or more. We 
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are going to be pleased if a 60-second 
operation becomes a 40-second one. 
Something that takes two minutes will not 
be lauded, even if the previous best was 
three minutes, simply because it is still 
stretching our patience. Money permit- 
ting, get a Gold Card first; anything that 
seems slow then will stick out like a sore 
thumb. If you want more speed - and many 
more functions - have a good look at 
| Text87 Plus-4 and Perfection Special 
Edition. 

You may think you don’t need anything 
| but Quill, but you are quite likely to change 
your mind after seeing a demonstration of 
one of these two wordprocessors. 


Price tumbles 


It may have seemed a bit pointless to 
mention in the April issue that it was (then) 
possible to buy a colour copying machine 
for under £2,000, but that was to empha- 
sise how fast prices come down in the 
computer world. Would you believe you 
can now (less than six months later) get a 
colour copier for under £900 (plus VAT)? 
Don’t get too excited, though. Just look at 
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the prices in the Miracle Systems advert 
and buy a Gold Card and ED drives in- 
stead; they'll be much more use to you. 
Leave the colour machines for another 
year or so (in case you are interested, both 
of the quoted prices are for Brother ma- 
chines). 


Always wanting more! 


The pace of development of Perfection 
Special Edition and Text87 Plus-4 seems 
to have got faster rather than slower. All 
the changes that have been passed to me 
are worthwhile ones, adding significant 
extra functionality or convenience to the 
use of the programs. Watch the adverts for 
details of new features. A full review of the 
latest Plus-4 should appear this month. If, 
like me, you are not satisfied with just one 
wordprocessor, you can now have sev- 
eral, and have more than one document 
loaded into each, and have your favourite 
database on-screen at the same time too. 
Check the illustration - one Perfection 
document at the top, a FlashBack record 
overlaid onto that, and one Text87 Plus-4 
document at the bottom; Ctrl-C then takes 
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you to other documents or programs which 
are loaded. All three programs displayed 
allow you to move and resize their screens. 
The ever-faithful Q_Switch provides the 
indicators at the top of the screen; this is 
one program that looks set to remain on 
my QL ‘for ever’, inthe same form as it was 
configured years ago; it has been great 
value, but is presumably unavailable now. 


And now hardware 


Rumours floating around suggest sev- 
eral hardware wonders may appear be- 
fore the end of 1992. A fast-graphics board, 
lower- and higher specification Gold Cards, 
a go-faster QL (a replacement rather than 
an add-on board), a QL emulator to fit in a 
PC, an improved hard disk interface, etc. 
As with all such rumours, they should be 
taken with a pinch of salt, but it does seem 
likely that at least one unit fitting one of 
those descriptions will see the light of day 
before long. Itis established that the 68020 
cpu chip can be used in association with 
the existing QL, but we can expect any 
serious new development to be based on 
the 68040 (the 68030 is a starter, but looks 
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less-and-less suitable as time goes by). 
Still one up 


Having had occasion recently to ask for 
a quotation on a high-end PC, | found with 
surprise that there do not appear to be any 
floppy disk controllers available which can 
support ED (2.88 MB) drives on PCs. Can 
it be that Miracle Systems are the only 
buyers of these drives in the UK? If so, all 
the more credit to them for bringing them 
| to us, at a good price. It seems incredible 
that one can get hard disk drives with GB 
(gigabyte) capacity, CD-rom disks with 
500-plus MB capacity, and 50 MHz proc- 
essors, yet have to settle for 1.44 MB 
floppy drives as a maximum on the PC. 


Readers’ letters 


Dilwyn Jones Software have written 
to reply in advance to possible criticism. 
As of early June, the update to the Page 
Designer V 2 Plus - had not been com- 
pleted, and there is no firm date for the 
necessary work to be finished. Money that 
has been sent in is being held, and not 
banked, until copies of the program are 
ready to be shipped. The hope is that this 
will be by mid-July. The reasons given for 
the delay are pressure of other work and 
underestimation of the time needed for 
the program changes. (Ali the usual!) It is 


refreshing to have a reply from a sup- 
plier before a complaint is received! 

Digital Precision have asked that 
another warning be published about 
sending blank cheques through the 
mail. While DP is happy that custom- 
ers place such trust in them, they are 
worried about the possible conse- 
quences of a letter containing a blank 
cheque going astray and getting in 
the wrong hands. It is quite possible 
for cheques to be cashed by people 
for whom they were not intended. If 
you must send a blank cheque to 
anybody, mark it ‘A/C PAYEE ONLY’. 
This warning is made for users’ own 
good; it must be stressed that nobody 
has complained to me about any 
cheque being cashed by the wrong 
person. 

Brian Wray wrote to complain that 
Digital Precision had not refunded 
the purchase price of a copy of the 
Payroll program, although they had 
returned his master disk after check- 
ing it. DP replied that Wray’s problem 
with the program had been caused by 
not observing the written instructions, 
and that there was nothing wrong 
with the program disk. The section of 
the program which deals with National 
Insurance contributions had to be up- 
dated by the user whenever the con- 
tribution rate was changed. However, 
they are contacting Mr Wray again 
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and will supply him with an updated 
version of Payrol/; the delay was due 
to a problem over payment for the 
program. Other users who bought 
Payroll from DP (not from PDQL) 
should contact DP for details of the 
upgrade, if they require it. 

PH Tanner wrote again - an even- 
longer letter than before. Long enough 
to fill this issue, in fact! Among many 
other comments, he said that “One of 
my machines runs 24 hours a day, all 
I/O taking place via NET”. My own 
machines run 10-15 hours per day, 
but virtually never overnight, mainly 
because everything done on them 
requires my input, whereas Mr Tan- 
ner sets his QLs to calculating and 
lets them get on with it. Note the use 
of the network, and not with the aid of 
Toolkit I either. It is always hearten- 
ing to hear of someone who has had 
a business lifetime working with bet- 
ter-known, and bigger, computers, but 
prefers to use the QL during retire- 
ment. In this case, the QLs certainly 
work for a living, too. Can anyone 
give an up-to-date report on the GST 
Assembler? |n particular, has further 
de-bugging been done on it? 

No reply has been received to the 
various complaints passed to TK 
Computerware in the past month or 
so. 
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text8 7 plus4 


+] UsER FRIENDLY TO THE EXTREME 


e New well-written manual e Automatic setup and 
Installation « Context-sensitive help « File selector boxes « 
Commands and key-presses highly compatible with Quill. 


+2 THE MOST POWERFUL QL WP 


« Extensive navigation and editing « Fast block and 
search / replace operations « Reformats as you edit « 
Remembers paragraph formats between sessions « 
Extensive file commands e Spell Checker with browse 
and replace « Multi-Window Multi-Document « Page- 
Preview and Pagination save a lot of time and effort. 


+3 > UNRIVALLED PRINT QUALITY 


« Nothing else can compete in text and character 
formatting « Fully supports proportional spacing and 
justifies correctly « Multiple paragraph formats with 
different margins and line-spacing for each e Right, 
centre and decimal tabs * Multiple columns plus headers 


SPECIAL OFFER! 


and footers e Seune publishing with several different 
page layouts in the same document 


+4 FASTEST QL WORDPROCESSOR 


Amazing timings on QL (much faster with Gold Card) and 
Atari ST with QL emulator. A 70 page text (24,000 words, 
141,000 characters) was used « Load: 25s (STQL 17s) « 
Save: 37s (STQL 32s) e Search / replace (with auto- 
reformat) 580 instances: 43s (STQL 14s) « Change 
justification: less than 2s (STQL 1s) « Change right margin 
and reformat 65s (STQL 17s) « Move 10 pages from top 
to bottom (With manual marking and positions): 35s (STQ@L 
15s) ¢ Scroll screen 100 lines: 19s (STQL 5s) 


Fully compatible with all QL ROMs, Gold Card, ST Ql, 
Thor. Requires disk drive and 256K memory. 


Prices (inclusive of Air Mail to overseas) 
text87plus4 ' £ 79.00 
2488 drivers for 24pin and Bubblejet printers £ 19.00 
typesef90-deskjef drivers for all HP Deskjets £ 19.00 
typeset90-Epson GQ5000, EPL4100 /7100 lasers £39.00 
fountext88 + founted89 £ 39.00 
Graphic driver for 9 & 24-pin printers with over 30 founts 
Ask for our free, comprehensive leaflets. 


If you have paid over £59 for any other QL wordprocessor you can upgrade to text87plus4 


for only £59. The manual from the other software is required as proof of purchase (It will be punched and returned) . 
Offer expires end of August 1992, Send cheque, Eurocheque, to: Software87, 33 Savernake Road, London NW3 2JU 
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Fax rolis for printers 


Reader P J Hudson has followed up his comments in Bryan Davies’ column (page 4 of the April 1992 QL 
World) on the use of fax paper with the Serial 8056 printer, by contacting supplier Office World (full name 
Globus Office World Plc) of Reading. Their Summer (May to August) catalogue (‘We guarantee that our 
prices are absolutely rock bottom!’) lists various sizes of fax roll paper, used by some QL World readers as 
a convenient source of printer-paper for reel-fed machines. The relevant price list can be found on page 107 


of the catalogue under Fax Rolls. 


Mr Hudson points out that the 30m rolls have the correctly-sized core for use with the Serial 8056, and his 
custom of re-winding the 100m rolls is simply to take advantage of economies of scale, Office World deliver. 
Office World has stores in Leicester (0533 516222), London (081 961 8244), Northampton (0604 
34456), Nottingham (0602 599499), Reading (0734 568865), and Slough (0753 551234). Enquire there 
for up-to-date prices and catalogues. 


Clarifica- 
tion hy 
Software 


$7 


At the time of placing their 
advertisement in the June 
1992 issue of Sinclair QL 
World, Software87 (the 
producer of text87) was 
unaware of the existence 
of the Digital Precision 
program Perfection Spe- 
cial Edition. The bench- 
marks quoted by Soft- 
ware87 in that advertise- 
ment hence definitely did 
not refer to the Special 
Edition of Perfection, 
which is understood to be 
much faster than the 
standard version of Per- 
fection. In addition, Soft- 
ware87 would like to point 
out that the benchmark for 
Search and Replace quoted 
by Software87 in the same 
advertisement may have 
been unfair to the program 
actually referred to. Soft- 
ware apologises to Digital 
Precision for any incon- 
venience caused. 
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Speccy Emulators in Italy 


Ergon Development is bringing to light two Spectrum emulators for 
the QL. The ZM-2 and ZM-3 ZX Spectrum 48K emulators emulate all 
standard Spectrum features (keyboard, tape reading and saving on Qdos 
devices) except sound. The two versions give a choice of facilities: the 
ZM-2 runs more slowly than the ZM-3, but has a higher compatibility 
rating. For instance, on a 16 MHz Gold Card games run on the ZM-2 
from 35% to 70% of normal Spectrum speeds, while on the ZM-3 they 
run from 50% to 90% of normal speed. Speed, of course, depends on 
various factors, such as screen redrawing, screen mode, instruction type 
executed, and so on). 

As for compatibility, some of the games quoted as running ‘excep- 
tionally well’ on both emulators are Jetpac, Pssst, Sabre Wulf, The 
Hobbit (Ail? Thorin), Atie Atac, Manic Miner, UnderWorld and Knight 
Lore. The emulators are controlled by the ‘Supervisor’, which allows 
users to manage Spectrum files on QL devices, to disassemble/dump or 
poke the Spectrum memory, to redirect Spectrum keys to QL cursor 
keys, and more. 

The complete ZM-X (ZM2 and 3) system costs £35 and is supplied 
with QL programs (on disk) and Spectrum programs (on tape) for 
transfer to the QL through the network or the serial port, for example, 
with the Interface 1), Ergon have also developed a full working public 
domain version, the ZM-1, 

Prices quoted do not include carriage (£5 airmail postage), Please 
send cheques or (preferably) Eurocheques in Italian lire (£1 - 2200 lire), 
OR add £4 to cover conversion fees if sending any currency cheque 
other than lire. 

Ergon also offer discounts on Lotal orders: £3 off for two programs, £6 
off the three programs, and so on. Please make payments to Davide 
Santachiara. 

Orders and enquiries to Ergon Developments, Via Emilio de Marchi 
n “*, 42100 Reggio Emilia, Italia. Tel (Italy) (+39) 0522 70409. 

Ergon have also just released Open World 2.1, to allow QL users to 
convert graphic screens created with other computers into standard QL 
screens. It can import IFF (Amiga), CUT, TIF (PC and Mac) and GIF 
files (mainly from bulletin boards). Images can be converted into four 
colours, eight colours, or monochrome (with a very powerful dithering 
algorithm) screens. The monochromes are ready to be loaded into QL 
desktop publishing programs. Open World (OWR) costs £25 and comes 
with a supervisor program, and two 720 K disks full of GIF, [FF and TIF 
images. 


Merz 
releases 
OSpread 


Merz Software's QSpread 
spreadsheet for the QL, run- 
ning under the QJump Pointer 
Environment, is now ready for 
market. The early news from 
Jochen is that the program ts 
fully pointer- and keyboard- 
driven, can split windows three 
times vertically and horizontally, 
giving a total of nine working 
windows; is formula-oriented, 
so that formulas can always be 
retrieved, even after numerical 
input has taken place (unlike 
Abacus); allows function mac- 
ros; allows a total of 32,767 cells, 
laid out in whatever horizontal 
and vertical configuration the 
user chooses, Block handling and 
number value entry has been 
made ‘a lot easier’ than in Aba- 
cus. 

As usual, all necessary pointer 
environmentand menus material 
is included in the package. 
Qspread will cost £49 from 
Jochen Merz Software, im 
stillen Winkel 12, D-4100 
Duisberg 11, Germany. Tel. 
101 49 203 501 274. 

Further news from Merz: the 
SerMouse driver is now in ver- 
sion 2.00, with smoother mouse 
movement and other improve- 
ments. The QL Emulator for the 
Mega STE ts in prototype, and 1s 
expected to be ready by August. 
More news when that arrives. 
QDesign 2, the upgrade to 
QDesign, improves on the origi- 
nal Qdesign inanumber of ways, 
but the incompatibility with early 
QL rom versions (according to 
our report, this includes early 
Minervas) remains. 
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EEC Ltd. are continuing to produce their improved 
MGT Lifetime Disk Drive, which is now sold as the 
EEC Universal Disk Drive. A | MB version is 
available at the reduced price of £70 (VAT-inclusive), 
and the 2 MB version at £90, which is half the original 
MGT price. The price includes an instruction book, a 
free 3.5 in disk, and a connecting lead for any one of 
the following computers: Sinclair Spectrum, QL, IBM 
PC or compatible, BBC, Amstrad, Atari, and Amiga 
computers. Extra leads are £12 each. 

A kit of parts can be bought, consisting of a case, a 
transformer, DIP switches, and a data socket, for £23 
plus £5 postage. This is for users wishing to make 
their own drives or customised units. EEC can also 
supply | MB and 2 MB drives at £29 and £49 re- 
spectively, and power supply units for 5V drives at 
£6. 

The | MB version will format up to 720 K with 


the 8049 


Hermes is a replacement Intelligent Peripheral 
Controller (ipc) chip developed for the QL by 
Minerva’s Laurence Reeves, and marketed by 
Minerva’s regular agent, TF Services. 

Hermes is designed to replace the QL’s own ipc, 
the IPC 8049, which has presented users with certain 
problems since the QL was invented. Among the 
best-known problems with the original IPC 8049 are 
poor handshaking on serial input (sometimes requir- 
ing a full reset); keybounce, especially with early PC 
add-on keyboards; lack of independent baud rates; 
inaccurate sound functions. 

These are among the problems which Hermes cures. 
The literature lists more precisely: two-key rollover, 
even with Shift; fully reliable serial input up to 
19200 baud with one stop bit, assuming that the [C25 
output buffer is working correctly and handshaking 
is enabled at both ends, and connected (check your 
serial cable and make sure the ports are open); differ- 
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Hermes steps in where 


double-density disks. The 2 MB version (which also 
reads double density) will format up to 1.44 MB, provid- 
ing the system will support it. 

EEC are still supplying QL and Spectrum computers 
and hardware including microdrive expansion kits, 
microdrives and parts, as well as cartridges, although 
these are no longer manufactured. All prices include 
17.5% VAT. 

Bill Richardson is also stocking the Serial 3-Button 
Mouse at £45, and the Infra-red Remote Mouse at £55. 
These fit externally into Ser2 with no internal fitting 
required. They come complete with interface and soft- 
ware. According to advance publicity, the 3-Button 
mouse offers five more functions than the Qimi. 

Orders and information from 

W N Richardson & Co., 18-21 Misbourne 
House, Chiltern Hill, Chalfont St. Peter, Bucks SL9 
SUE. Tel. 0753 888866. 


leaves off 


ent baud rates for each serl and ser2 input lines, and 
separate from output (can be used to drive a serial 
mouse and a printer from serl simultaneously. Open/ 
closed status of serial ports can be read; code to handle 
three spare I/O lines (one is used by the Qview capsled 
kit) Three other input lines can be read; keyclick toggled 
on and off; Reset/INT77 invoked more safely; function 
to return ipe version number, 

Fitting involves removing the top of the QL and 
replacing the IPC chip. full instructions are included. 
Also included is a small extensions file to be loaded 
with RESPR. 

The Hermes package costs £25 inclusive of chip, 
disk, VAT and UK postage, from TF Services, 12 
Bouverie Place, London W2 1RB. Tel. 071 724 9053. 
Personally, we would wrap up our old chip and keep it 
in a safe place, rather than filing it where Laurence 
recommends - why contribute to a landfill when you can | 
clutter your cupboards? 
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PEN WHANNEL 


Open Channel is where you have the opportunity 
to voice your opinions in Sinclair QL World. 
Whether you want to ask for help with a technical 
problem, provide somebody with the answer, or 


just sound off about something which bothers you, 


write to: 


Open Channel, Sinclair OL World, The Blue Barn, 
Tew Lane, Wootton, Woodstock Oxon. OX7 1HA 


Assembler 


Earlier this year you asked about 
an assembler and aC compiler for 
an unexpanded QL. The only as- 
sembler [ have ever used on the 
QL is the Assembler Workbench, 
published originally by Talent. It 
is well adapted for the unex panded 
QL. Not only that, but it comes 
with excellent on-line help, and a 
good range of monitor and debug- 
ging facilities. It also has a great 
little text editor with it, for writing 
programs. [use this to write Forth 
programs as well as assembler 
listings. It lacks some of the facili- 
ties of bigger and more expensive 
packages, The most important 


Services. 


14 


THER 


Editor’s notebook 


Summertime, and the living is rainy. But 
not as quiet as we normally expect in 
July-going-on-August. This is no doubt a 
side-effect of our many moves with letters 
arriving thick and fast, either wanting to 
know what is going on, or congratulating 
us, or both. PaulinE and Fran are correct- 
ing the Subscribers list by hand, which 
may mean more rational overseas ad- 
dressing in the future. 

The hardware and software community is 
also hard at work. In particular we have 
new software news from Jochen Merz in 
Germany and Ergon Developments in 
Italy. We also have (slightly delayed) 
news of the Hermes replacements IPC 
chip for the QL, produced by Minerva’s 
Laurence Reeves, and marketed by TF 


| won’t pretend that we’ve entirely caught 
up. We're behind with reviews and the 

open Channel proofs are emerging in a 
funny order - but we’re getting there. 


factoris lack of macros. However, 
you only really need these if you 
are writing big programs which 
would require memory expansion, 
and so you would not use them on 
an unexpanded QL anyway. As- 
sembler Workbench has never 
lacked in any facility I found any 
need for, and as it seems to be 
cheaper than any other assembler, 
it is almost certainly the best buy 
for someone who has an 
unexpanded QL. 

As for C compilers, 1 have 
dabbled in C for a couple of years 
now, both on the QL and on IBM 
compatibles. But I have not writ- 
ten any serious program in it. It 
clearly isa very good language for 
those involved with large pro- 
gramming projects, ifonly because 


of the enormous libraries of rou- 
tines available to start you off. But 
for small programs (less than, say, 
32K) it is much too complicated a 
process to go from source code to 
final program. Itis somuch quicker 
and easier to program in assem- 
bler, or Forth, or even Basic, and 
then compile the Basic. 

To use almost any C compiler 
will require memory expansion, 
and even if it works with an 
unexpanded QL, it is unlikely to 
be very useful. However, if I were 
going to start experimenting with 
C on the QL, I think I would get 
the public domain C68 C com- 
piler trom Qubbesoft. It's good, 
it’s continually getting better. and 
it’s free (apart from copying 
charges). It’s the only one I have 
actually tried on the QL, although 
I have tried several C compilers 
for IBM compatibles. 

Alan Bridewell 
Swindon 


Racket 


Are you a QL criminal? In you 
live in that little island north of 
France, and have a personal com- 
puter then, undoubtedly, you are. 
David Drysdale must have diffi- 
culty speaking with his tongue 
firmly in his cheek. 

Tbought my QL in March 1985, 
and used it for writing letters. The 
first thing I did was to produce a 
cartridge with names and ad- 
dresses, so that T could print en- 
velopes and merge addresses for 
business letters, without having to 
type them. | now have 600 ad- 
dresses on three disks, duplicated, 
of course. 

I can openly state the above, 
because in Andorra we do not have 
such an act as the Data Protection 
Act of 1984. For the last two 
months, doubtless in all innocence. 
there have been articles in Quanta 
specifically trying to teach users 
how to enter addresses and tel- 
ephone numbers using Archive. 

The greatly-increasing use of 
electronic diaries and notepads 


means that people other than com- 
puter users are doing the same, 
with the addition of telephone 
numbers, what the person or 
company is or does, their part- 
ners’ names, etc., etc, PC pro- 
grams are commercially available 
for this purpose. 

The act was made law for very 
good reasons, but at the time the 
use of personal computers had not 
taken off as it has since. The act is 
certainly still needed, but it must 
be amended so that you are notall 
criminals tn future. 

Ithink that computer magazines, 
computer manufacturers, and 
others concerned should write 
letters lo the newspapers, the 
Government, lobby their MPs, and 
generally highlight the absurdity 
of the particular section of the act. 

This is intended to start the ball 
rolling, instead of everyone be- 
having ‘criminally’ and doing 
nothing to get the situation 
changed. 

Gil Lamb 
La Massana 
Andorra 


E-mail 


Some news that might interest QL 
World readers. Any QLer who 
has access to the worldwide net- 
work that links many mainframes 
should get in touch with Giuseppe 
Zanetti whois collecting the names 
of QL users. His e-mail address is 
‘beppe @alessia.del.unipd.it’. He 
will supply a list of names and e- 
mail address on request. There are 
only about 30 so far, short of the 
100 required to setup anews group 
devoted exclusively to the QL, so 
we have decided to post QL-re- 
lated news items on 
‘comp.os.misc’. Professor Timo 
Salmi in Finland has also made his 
QL programs available on an 
anonymous FTP © server, 
‘garbo.uwasa.fi', these can be 
downloaded over the net, and he 
will also accept files from others 
to add to the collection. 

I haven't attempted to explain 
the details of how to access the net 
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since I imagine those of your 

readers who have the facility will 

already know how to do it - and 

anyway, the procedure varies 
from machine to machine. 

Howard Clase 

St John’s 

Canada 


What rom? 


In Sinclair QL World in April 
1992, on page | 2 under the head- 
ing ‘Byron’ [ read for the first 
time in my life - of the existence 
of a JSU rom in a QL, At the 
moment] also know of aJM rom, 
a JS rom and an AH rom. 
Which rom is the best? Which 
romis the worst? How many types 
of rom exist in total? Can some- 
body give me an answer to these 
questions? 
Thanking you in advance, I 
remain: 
M L Huppe 
Lauwerecht 201 
515 GR Utrecht 
The Netherlands 


Comment: Ifanyone can compose 
the short answer to this broad 
and rather personal question, we 
will print it in Open Channel. 
Meanwhile, we will consider the 
possibility of publishing the long 
answer, but not in Open Chan- 
nel, 


Slashed 


Calloo, callay, oh frabjous day, 
and all that. [tis great to have you 
all back in circulation. Long may 
you continue so. 

Only one thing clouds my view: 
The QL remains so exactly 
matched to my needs that I find it 
difficult to believe that anyone 
else could find a use for it. [live 
interror that the bubble will burst 
and I will wake up one morning 
to find myself the lone surviving 
user. 

But [am not writing only to 
congratulate: there are two other 
matters, less important but which 
should nevertheless be brought 
to your attention. 

The fount used for the listings 
in Open Channel is not wholly 
suitable. The minus signs are al- 
most invisible; the distinction 
between colon and semicolon is 
very fine; and the zeros really 
ought to be slashed. 

Which brings me to the second 
problem which concerns me. You 
printed a scrap of my own code 
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on page 15. Sadly there is a translit- 
eration error. A double vertical line 
(_ ), signifying a bitwise OR, has 
become a double underscore in line 
1040. It may have been my fault: 
my printer prints a vertical line as a 
broken vertical line, and it is my 
usual habit to fill in the gap by hand. 
It is possible that | omitted to do so. 

If anyone should need a listing 
straight from the source, | would be 
happy to supply it. 

Funny to see your comments on 
the colour of the fields. In my pre- 
war East Anglia youth they were 
bright yellow too, but a much 
‘cleaner’ colour: they were grow- 
ing mustard for the Colman mills in 
Norwich. 

Please keep going. Your efforts 
are greatly appreciated. 

P H Tanner 
Glasgow 


Comment; Having had another look, 
fam going to vote a disagreement 
with you on the clarity of the listings 
print: I find the colons and semico- 
fons are distinct, and the minus 
signs quite clear, ifa bit small. The 
0 and the O are among the most 
distinct I have seen in any typeface, 
However, this is the first comment 
on this subject | have had from a 
reader, and I would be very pleased 
to see further opinions. 

f may have read the missing ver- 
tical lines as broken lines, but the 
underscore is a transtation error - 
it was in order last time I looked at 
it. | think this is one of the few 
characters which is going to g0 on 
giving us trouble, 

It's a bit sad that oilseed pollen 
upsets so many people, especially 
as it’s a close cousin of mustard. 
and surely no more non-organic 


than hay (as in ‘hay fever’, of 


course). A friend from Norwich 
says: ‘P’dappreciate it more if there 
wasn't so much of it.’ 


Entitled 


Having recently purchased a Sony 
camcorder (from Comet, with a 
subsequent refund of over £50, be- 
cause of the price of a competitor), 
I thought it might be possible to do 
titling with the QL. I contacted 
Jonathan Oakely, who explained 
that as far as he knew, il was not 
possible for the QL torunaGenlock 
system (which is necessary if you 
want to merge two video signals). 

I then tried using Page Designer 
2 to make titles and photograph 
them from the monitor, not very 
successtully due toreflections. With 


100 WMON 
110 WINDOW #0,512,256,0,0 


120 CLS #0: REMark BLANK SCREEN 


130 WINDOW #0;512,10.0,246:PAPER #0,0:INK #0,2 
140 WINDOW #1;448,60.32,0:PAPER #1 .0:INK #1,7: REMark INPUT WINDOW 
150 WINDOW #2:448, 186,32,60:PAPER #2,0;INK #2,7:REMark DISPLAY WINDOW 


160 CSIZE #1.3,1 

170 CSIZE #2,3,1 

180 DEFine PROCedure RULE 

190 PRINT #1, °F PP TPP eps 
200 END DEFine 

210 DEFine PROCedure CLSALL 

220 CLS #1:CLS #2:CLS #0 

230 END DFFine 

240 ERT HOT_REMY (C) 


250 ERT HOT_CMD (‘C’CLS #1') : REMark CLEARS THE INPUT WINDOW 
260 ERT HOT_CMD (‘T’input”sprg$’,’ print #2,pre4°) 


Toolkit 2 users should lose line 140 and replace 250 and 260 with: 


250 ALTKEY °C’,CLS #1'."" ;REMark CLEARS THE INPUT WINDOW 
260 ALTKEY ‘I’ input” spres’. print #2.pre° 7" 


further thought, it was obvious that 
a monochrome signal could be used 
as it was the required composite 
video signal, but experiments in 
linking the monitor lead to the 8mm 
video recorder via the edit unit not 
only gave the title, but also all the 
unwanted rubbish on the screen. 

It became apparent that what was 
needed was a completely blank 
screen which was the full 512 by 
256 pixels. The nearest I could 
achieve was to have a one-line (512 
by 10 pixel) window 0. Paper 0, Ink 
7, Csize 3,1: a nine-line (448 by the 
remaining 186 pixels) window 2, 
With no borders, this gives a blank 
screen and the red ink on black in 
window () makes any typed-in com- 
mands almost un-noticeable on the 
video screen, The 448 width of win- 
dows was arrived at by experiment 
in order to keep the characters away 
trom the edge of the screen, which 
however led to another small prob- 
lem, which was casily solved. A 
strip each side of the windows re- 
mained uncleared. To remove this, I 
decided to first define window 0 to 
the full 512 by 256 pixels, CLS #0 
and then redefine the windows. 

Input into window 1 is transferred 
to window 2, and then CLS #1 clears 
window | (Alt-C). Two procedures 
are used: Rule is a rule which ap- 
pears in window | to facilitate 
spacing and Clsall clears all win- 
dows. Although limited to the QL’s 
character set, this is a very cheap 
option for titling (character genera- 
tors start at £150). If you think 
computer equipment is expensive, 
try video: camera £395 to £1999, 
video recorder £220 to £1799, and 
an editor with mixer and fader/en- 


hancer facilities £59 to a full editor 
system including character genera- 
tor with memory £4999, Of course, 
my equipment costs the lowest of 
these prices. I hope the listings will 
be of use to those who can only 
alford the older type of cameras 
with no built-in titling facility. 
Peter Rowell 
Quanta and Cambridge 
Archimedes and 68 Group 
(Case) 


Abacus 


Referring to Peter Tomlin’s letter 
Q, Abacus 2.00 accepts the dollar 
sign S. What this does ts to make 
cell references absolute. Forexam- 
ple, if cell Al contains 10, cell B1 
contains 20, and cell Cl contains 
$Al + BI, cell Cl will show on 
screen the value 30. Echo cell Cl 
(use F3:E:C1 across range C2;C4) 
and cells C2 to C6 will now contain 
the value 10. If you move the cur- 
sor onto cell C2 (for example), in 
the bottom left of the screen the 
formula $A1 + B2 will appear- Al 
is an absolute reference, whereas 
BI was taken as a relative refer- 
ence. 

To use the dollar sign, type it in 
as part of the formula, forexample: 
B1 + B1 * $8C2/100, entered into 
cell D1, could be used to calculate 
a VAT-inclusive amount, if C2 
contained the current rate of VAT. 

Rich Mellor 
Walsall 
W Midlands 
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Lively in 


Dilwyn Jones reports from the re- 
cent Quanta workshop in London 


The recent workshop on the 
30th of May 1992 ina church hall 
in North Kensington was organ- 
ised by the London group affili- 
aled to Quanta, the UK QL User 
Group. The yenue was easily 
accessible both by car and by 
public transport. 

Quanta workshops are mini- 
shows where members (and often 
other users) can come along and 
meet other QL users, meet QL 
traders to buy items for their QLs, 
ask questions, get help with their 
problems and attend informal 
lectures and discussions organ- 
ised on a wide variety of subjects. 

Non-members can come along 
too - admission is usually free 
and there is no obligation to join 
Quanta, although you may want 
to do so when you see all the 
activity and benefits which can 
be obtained from membership of 

| the group. 

Most of the well-known QL 
traders came along to set up shop, 
including Digital Precision, 
Miracle Systems, DJC, EEC, 
Qubbesoft, QBits, Liberation 
Software, CGH Services, CL 
Systems and Software 87. 

Freddy Vachha of Digital 
Precision gave an all-day dem- 
onstration of his company’s soft- 
ware for the QL and talked at 
length on a number of subjects. 
Miracle Systems showed their 
range of hardware for the QL. 
The Gold Card is now apparently 
selling very well following the 
recent price reduction to £225, 
Miracle were displaying what I 
think was the smallest QL serial- 
to-paralle! printer port converter 
I have ever seen - the circuitry 
was small enough to fit into the 
cover of the printer connector, 
The device I saw was only the 
prototype unit, but we believe it 
will be on sale soon, 


Trump swap 


Miracle may be launching a 
number of new QL. products this 
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year, so we eagerly await them. 
Their well known Expanderam card 
and Trump Card will now be pro- 
duced and sold by Qubbesoft - Ron 
Dunnett told me that the good news 
is that there will be a modest price 
reduction on these two items. See 
this month’s QL Scene for more 
details. 

Fred Toussi of Software87 dem- 
onstrated and sold the Plus4version 
of the word processor rext57, This 
is aremarkable program, well wor- 
thy of ademonstration the next time 
you see Fred at a QL show. 

CL Systems exhibited their 
CQVI QL Video Digitiser, now 
available in a version compatible 
with the Gold Card. Mr Lang sam- 
pled pictures onto disk for custom- 
ers, using a video camera. TF Serv- 
ices were selling anew device called 
Hermes. This is a direct replace- 
ment chip for the 8049 IPC unit in 
the QL, providing a number of im- 
provements. It helps to solve the 
serial input problems on the QL, 
giving split-input baud rates on both 
serial ports, and much improved 
keyboard de-bounce. It can provide 
three input/output lines and many 
more features. The price was £25.00. 
Contact TF Services for further 
details. Tony Firshman said that 
both the standard Minerva eprom 
and the MKII version are still sell- 
ing well. 

CGH Services” stand had a 
number of leisure programs for the 
QLandaselection of QL magazines 
such as the QL Technical Review. 
QL Leisure Review and the Inter- 
national QL Report, an informative 
magazine originating in the USA, 
but with subscribers all over the 
world. 


Second users 


Several traders were selling a 
number of second-user bits and 
pieces for the QL. QBits and 
Qubbesoft, for example, both sold 
various items of software, hardware, 
spares and old books and maga- 
zines - several visitors said it was 


worth the trip just to browse through 
the contents of such stands. 

An interesting device was avail- 
able from the QLEA stand. QLEA is 
the East Anglia Quanta sub-group, 
The QL ROM Switching Board ts a 
small PCB which fits inside the QL 
and allows you to have two QL roms 
present, including a Minerva, which 
can be selected at the flick of a switch 
and a reset. A two-colour led indica- 
tor tells you which rom is in use. The 
benefit of this to users and software 
writers is that software testing Is sim- 
plified - there is no need to dismantle 
your QL to change roms to test a 
program, or run a program which 
will not run with a Minerva installed, 
for example. The device is modestly 
priced at £25.00 plus a fitting charge 
(unless you fit it yourself). 


Various talks took place on the 
stage area during the day, including 
Dave Walker’s discussion of his 
excellent public domain C-68 C 
language compiler for the QL and 
Chris Boutal’s talk on the fascinat- 
ing subjects of Genealogy and his 
best-selling QL Genealogist pro- 
gram. Fred Toussi also gave a talk 
on text87 Plus4. 

Due tothe bad weather all over the 
country during the week before, this 
was not the best attended of Quanta | 
workshops, although they are al- 
ways great fun to attend. Quanta 
workshops are planned for Newcas- 
tle-upon-Tyne, Nottingham and 
Thetford later this year and possibly, 
by the time you read this, more ven- 
ues will have been added. Why not 
vo along and join in the fun? 


TheSpectrum's 
Birthday 


Simon Goodwin held a birthday party 
for the Sinclair ZX Spectrum - 10 


years old this May. 
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Britain's best-selling computer, 
the Sinclair ZX Spectrum, cel- 
ebrated its tenth birthday this May, 
at a party organised by ZX enthu- 
siasts inCambridge, the Spectrum’ s 
birthplace. 

The Spectrum followed Sinclair's 
ZX 80 and ZX $1 computers, and 
was known internally as the ZX 


| 82. A decade on, after some seven 


million sales of Spectrum vari- 
ants, ZX 92 was the obvious name 
for the anniversary re-union. 

Spectrums, emulators, clones 
and eager users gathered at the 
Boat House pub, beside the river 
Cam. Star guests included John 
Mathieson, who joined Sinclair 
Research in 1981, wrote the origi- 
nal Spectrum brochure and tested 
the ZX rom before its release a 
decade ago, MGT founder Bruce 
Gordon brought old prototypes of 
his SAM micro, the true successor 
tothe Spectrum, and new hardware 
under development. 


Party music 


The party featured a soundtrack 
of Spectrum-generated music, in- 
cluding Prokofiev’s March of the 
Capulets rendered for 128K sound 
chip by muso Jon Bates, and 
Overiure for Toad, an atmos- 
pheric MIDI sequence in the style 
of Philip Glass. 

Cheetah’s excellent Specdrum 
was used on many tracks, as were 
the RAM Music Machine and 
home- brewed software for effects 
and digital delays. Coventry band 
Relevant POS contributed catchy 
pop via their home-made interface 
for Wasp synthesisers, making a 
personal appearance with fans in 
tow. 

Jamaican reggae and ska were 
represented by Norman Hall, plus 
guitar polemic from TI/TO, with 
former Crash and Sinclair User 
minion Garth Sumpter on vocals. 
Blues songs from Mel Croucher of 
Automata recalled the spirit of ZX 
Microfairs. Even Doctor Who 
made a contribution, in the shape 
of an out-take from Automata’s 
classic Deus Ex Machina, narrated 
by Jon Pertwee! 

John Mathieson brought two rare 
variants of the Spectrum: a white 
48K model, produced to celebrate 
the millionth machine produced, 
and a unique Spectrum Plus, also 
moulded in white plastic as an ex- 
periment when Sinclair considered 
changing the case colour for the 
new model. 

The original ‘Issue One’ Spec- 
trum made an appearance, with 
the last-minute ‘dead cockroach’ 
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modification exposed - an extra 
chip soldered upside down beside 
the main logic array, needed to 
make early production keyboards 
work. 

Downstairs in the bar another 
Spectrum development was earn- 
ing its living, Delegates spotted 
the Treble Top pub game, a com- 
mon arcade machine built around 
the Flare One circuit board. This 
super-Spectrum was invented in 
1987 by three former Sinclair de- 
signers. It uses the same Z80B 
processor as the SAM Coupe, plus 
custom graphics and sound hard- 
ware. 

The party attracted many lumi- 
naries from the Spectrum sub- cul- 
ture, with a great spread of back- 
grounds and ages. The youngest 
delegate was no older than the 
computer, while the oldest had re- 
tired before the ZX range was born. 

Fanzine writers included John 
Wase and Nev Young of Format, 
David Ledbury of ZAT, veteran 
adventurer Margot Porteus and 
Fractal guru Ettrick Thomson. 
Commercial competition was for- 
gotten, as Glen Cook and Andy 
Wright discussed contrasting ap- 
proaches in their SAM Game De- 
sign suites, due soon from Betasoft 
and Glenco. 

ZX 92 was arranged by 
Sinclairphile and one-time Crash 
tipster Simon N Goodwin (me), 
and recorded for posterity by local 
media and Jon Pillar of Your 
Staclair. Awards of software, 
publications and hardware were 
shared in a Spectrum-moderated 
draw. Top prize was a rare and 
valuable Currah Microspeech 


voice synthesiser, donated by 
Betasoft. 


Spectrum CD 


Codemaster’s Spectrum Com- 
pact Disk package attracted atten- 
tion. This reads games from a 
normal CD player, linking the 
headphone socket to the Spectrum 
joystick port. You get 30 machine- 
code games, including several big 
hits, for £20 including the inter- 
face, ably demonstrating the size 
and economies of scale of the 
Spectrum market. 

The range and quality of Spec- 
trum software has encouraged mi- 
cro users to develop ‘emulation’ 
packages that let them run ZX pro- 
grams on other computers. William 
James’ excellent Spectrum emu- 
lator for the Sinclair QL was on 
display, running ZX BASIC and 
popular games from QL disk. This 
emulator should reach the public 
domain once documentation and 
software to transfer ZX memory 
snapshots from disk have been fi- 
nalised. 

Already, Dave Barker's public- 
domain QSPEC software is capa- 
ble of reading ZX cassette files 


and screens into memory, via the, 


QL network port. QSPEC is ayail- 
able from CGH Services and other 
PD libraries. Spectrum file con- 
version programs are also ayail- 
able from Quanta (disk Comms 
Xfer 2) and CGH Services (Con- 
nections disk 1). 

The Commodore Amiga has ZX 
emulators of its own, developed 
by Digimail of Milan, but the most 
technically impressive demon- 


MEETINGS 


stration at ZX 92 was a double- 
emulation, with the QL Spec- 
trum emulator running sweetly 
under the Public Domain Qdos 
emulator for the Amiga!> The 
Qdos emulator was developed 
by Rainer Kowalik of Berlin; it 
lacks sound and supports only 
four colours, so some of the 
Spectrum hues appeared as suip- 
ples, but otherwise the double- 
emulation seemed perfect. 


ZX on the PC 


Andy Wright's ZX emulator 
forthe Amstrad CPC range made 
a showing, alongside similar 
programs for the SAM Coupe, 
which was designed to run 48K 
Spectrum programs from the 
start. Bruce Gordon brought the 
original SAM prototype, hand- 
builton four circuit boards, with 
hundreds of TTL chips standing 
in for the custom ASIC in pro- 
duction models. He also dis- 
played the latest model, shorn 
of MIDI and TY circuits to fita 
paperback-sized board, and in- 
tended for process-control ap- 
plications. 

No less than three emulators 
for IBM PCs turned up at the 
party, via Germany, Spain and 
Holland, along with hardware 
emulators for minority British 
designs like the Memotech MTX 
and Tatung Einstein. It is still 
early days for emulation software, 
and you need a fast processor to 
match the speed of the original 
micro, but the future looks rosy 
as programs proliferate and chips 
rise to the challenge. 
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Text $7 
Into the 90s 


INFORMATION 
Program: Text87 Plus-4 
Price: £79 

Supplier: Software87 
33 Savernake Road 
London NW3 2JU. 


peed is a good selling point and has 
Speen much emphasised in connec 


tion with wordprocessors. This review 
was written on the basis of experience 
running text87 Plus-4 on a JS QL with a 
Mark 2 Gold Card and ED disk drives. 
There was also another ‘tweak’ in the sys- 
tem, in the form of the latest version of the 
Lightning display-enhancer program. 
These things smarten up the behaviour of 
almost any program, and itis easy to forget 
that life isn't quite so much ‘in the fast lane’ 
when your system doesn’t have them. It is 
safe to say that lack of speed should not 
seriously trouble any user of Plus-4, though; 
itgets on with the job without painful pauses, 
in a way that Quill cannot manage. 

The basic requirements for text87 Plus4 
are a QL (or Thor or Atari ST with QL 
emulator) having at least 256 KB of expan- 
sion memory in addition to the original 128 
KB, one disk drive, and a display which can 
handle Mode4 text. The program version 
referred to here is labelled ‘text87p4E3’ 
(‘T87’ from here on), the final digit indicat- 
ing release 3 of the Plus-4 program, cur- 
rent in early July 1992. This version has 
several enhancements, compared to the 
initial release version. 


Not cosmetic 


It is clear as soon as you start this pro- 
gram that it is no mere cosmetic face-lift of 
version 3. There is similarity in the menu 
structure and options, but a lot of changes 
have been made. That should not put off 
users of the existing versions, though, as 
they will find the style is essentially the 
same. There are simply more facilities 
available, and some of the existing ones 
have been made more usable. 

There were problems with the initial re- 
leases (several different versions were re- 
ceived during the period of this review), but 
the complaints of users were heeded and 
the faults quickly rectified. No serious bugs 
were noticed in the final review copy. Files 
saved with very early copies have to be 


loaded into the current version as Ascii 
text, and certain random characters at be- 
ginning and end of the text need to be 
deleted, to ensure compatibility. 

The basic formula is still the same. A 
‘real life’ screen, with dimensions in milli- 
metres or inches rather than in terms of 
fixed-pitch characters, different display 
founts to show both sizes and attributes 
suchas italics, automatic reformatting when 
changes are made to text or to ruler pa- 
rameters, ready-made printer-driver files 
to relieve the user of any fiddling, proper 
display of different justification modes and 
of proportionally-spaced characters, and 
on-line spelling checking. The new features 
include multiple windows, for 1 view of up 
to eight documents, or eight views of one 
document, or any combination. The win- 
dows are quite independent and spelling 
can be checked in all of them. 


Getting started 


Getting started is straightforward. A rou- 
tine is provided to enable creation of a 
working copy of T87, setting the default 
devices, and selecting a printer-driver. The 
defaultLayout, Ruler and Typestyle settings 
can be altered by the user. Allowance is 
made in printer-drivers for non-printing 
areas on the paper; you need to bear this 
in mind when setting margins. 

There is a fairly comprehensive on- 
screen Help feature, which should meet 
with general approval. The help text is 
initially loaded from disk, but then remains 
in memory (unless deliberately unloaded 
to release memory) and further use doesn't 
entail disk activity. F1 brings up the help, 
which is paged-through by means of the 
Shift-Up/Down cursor keyings. There are 
over 40 screens of help information, with 
eight lines on each, and the first screen you 
get is related to the commands menu you 
are currently using. Answers to most obvi- 
ous questions should be obtainable from 
here. 

T87 instruction booklets have met with 
complaint in the past and, in my experi- 
ence, the best approach was to read all 
through the booklet - several times - before 
getting stuck into using the program. Some 
of the terms used were (and still are) un- 
familiar, and the general style of the program 
was quite a bit different from Quill (which 
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was all most of us had met previously). The 
new booklet is well laid-out and clear to 
read. There is a Contents list at the front, 
but no Index (one is likely to be added, 
though); even in a relatively small publi- 
cation, much time can be wasted looking 
for references to a particular word in the 
absence of an index. 


Two menu structures 


As a sign of understanding to those 
users who found the menu structure of 
previous versions too complex to work 
with, two menu modes have been provided. 
One causes all menu options to be dis- 
played, in the appropriate groups, whereas 
the other deletes any options which are 
thought to be unwanted by users who are 
looking for only Quill-like commands. Thus, 
the File menu group - displayed when F3- 
F is pressed - shows Save / Load / Room 
/ Close / New / Merge / Export / Import / 
Zap, in its full form, or Save / Load / Room 
/Close in its short-menu form. The mode is 
set as a configuration default which re- 
mains in force until reset, allowing the user 
to work with the short set-up for a few 
weeks, while getting the hang of using the 
program, then switch to the full menus as 
confidence builds up. 

To alarge extent, the special features of 
the program can be ignored; you can just 
start typing once the working copy has 
been made. To do this is a sad waste of 
useful features, but you still have the greater 
speed and reliability, and the availability of 
a spell-checking function, when compared 
to Quill. 

Users of existing versions, and particu- 
larly those who have tried T87 and put it on 
one side, will ask whether or not functions 
are easier to use. Subjectively, my feeling 
is that there often tends to be one more 
keypress than is necessary to get the job 
done, but this is because of the effort that 
has been made to provide the maximum 
flexibility. The command names are mostly 
obvious ones, selection is generally by 
pressing the key for the first letter of the 
command, the Esc key takes you back one 
menu step (as it sensibly should do), you 
can restrict the number of menu choices 
and simplify matters by setting the ‘short 
menus’ default, the menu displays are clear 
and include some descriptive text. 
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For those who do not use a program 
every day - most of us? - the present 
structure is a sensible one, as you don't 
have to remember obscure key combina- 
tions; the 12-hours-per-day user will wish 
for some shortcut keyings, that can be 
memorised, and you can use the toolkit 
ALTKEY command for this. 


Key combinations 


Comparison with Perfection is inevita- 
ble, but generalisation on the relative merits 
of the menu systems is dangerous; what | 
will say is that - for me - T87 makes life 
easier by avoiding the necessity for re- 
membering masses of key combinations, 
but more difficult by making access to 
commands less direct. How the individual 
user reacts depends to a fair extent upon 
his/her memory (or, indeed, the frequency 
with which the program is used). 

One drawback to earlier versions was 
the inability to have more than one page 
layout in a document. You can now set up 
to 64 layouts per document; this ought to 
satisfy most users. All Layouts within one 
document must use the same page size 
and orientation, though, so you can’t mix 
portrait and landscape pages. In addition, 
there can be several Frames per Layout, 
and there can be odd and even Layout 
pairs for facing pages. There can be differ- 
ent numbers of Columns in different 
Frames. The maximum number of col- 
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umns is 4; the gap between columns can 
be set. 

The use of frames is similar to that in 
DTP programs, and will facilitate the 
creation of fancy newsletters and such. 
Text normally flows from frame to frame, as 
it does with linked DTP frames. Another 
new feature is a page preview. While this is 
far from being exactly what some PC users 
have got used to in recent years, it is 
comparable to that provided by Microsoft 
Word, for instance. The text is shown as 
solid blocks and is unreadable, whatever 
the size, but it allows you to get a reason- 
able feel for how the page will look when 
printed. The function is surprisingly fast. 
The lack of readability is presumably a 
result of the low resolution of the QL screen 
and should not be taken as a deficiency in 
the program. 


Many windows 


The availability of several windows makes 
life much easier, when your WP operations 
are less than straightforward. The first re- 
quirement was to be able to look at two 
different sections of the same, large docu- 
ment simultaneously, and that has now 
been fully satisfied; you can have as many 
as eight windows onto the same document. 
For anyone who tends to grass-hop (that 
definitely includes me when at the key- 
board), an even more important require- 
ment is to be able to have several different 
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documents loaded at the same time, and 
be able to switch quickly between them for 
editing. 

Itis not an oddball need: forexample, my 
current documents include this review, 
separate comments on T87 for the pro- 
grammer, comments on a beta-test ver- 
sion of another program, and a letter toa 
computer nut in Germany. There was a 
further document containing replies to | 
readers’ letters a few days ago. All this is 
now possible, with T87. The windows can 
be sized and moved around. The ability to 
have a few words of many documents 
visible simultaneously does not cut much | 
ice with me, as you get little enough text 
visible on a full 14 in screen as it is, but 
being able to switch quickly, and simply, 
between full-screen documents is very 
useful. 

Itis a pity that you cannot cut-and-paste 
directly from one document to another, but 
each document is unrelated to any others | 
and you have to Export the desired block to 
(ram) disk, then Merge it into another docu- 
ment. But this does not apply to different 
windows onto the same-document - you 
can mark a Block in one, then switch to 
another one and Move or Copy the Block. 


Frame happy 
The message ‘margins too wide for frame’ 


may be painfully familiar to many T87 us- 
ers, butis presumably no more now, as the 
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program will carry on and print even if you 
have set the Ruler margins wider than the 
Frame width. You are warned that the 
results may not be too satisfactory, though. 
There is a change in terminology for the 
Ruler, as Indent is now First Line Margin. 
Normal indented or ‘hanging’ paragraphs 
are no problem; the First Line setting speci- 
fies the indent of the first character of the 
paragraph from the start of the Ruler, and 
the Paragraph Margin sets the indentation 
of all successive lines, again from the start 
of the Ruler. The Ruler is now panned to 
the left to accommodate markers when 
they are placed beyond A4 width, making 
it easier to see what you are doing with 
wide layouts. 

We were all brought up on Quill, and 
came to expect to be able to look at a list of 
our document files, provided by Quill if the 
Load command was used. On ‘graduation’ 
to other programs, we found this facility 
absent, and we were forced to use Ctrl-C to 
go to SuperBasic to get a listing of files 
(displayed in a rather primitive fashion). It 
is good to see that Plus-4 has given us this 
important facility back again, in a very 
usable form. To obtain a listing of the files 
on the default drive; all you need do after 
selecting Load is press the up or down 
cursor key. The list contains only _T87 and 
_T91 (Plus-4) document files if you select 
Load, but all files are listed for other op- 
tions. Moving the highlight to the one re- 
quired, then pressing Enter twice, causes 
the selected file to be loaded. To check 
other devices, itis necessary to type in the 
device name (eg ram1_), then press the 
up/down cursor key. 

Among the features which will be praised 
or cursed, depending upon the outlook of 
the user, are retention of the last cursor 
position when a document is reloaded. To 
my mind, this is a very desirable feature, as 
there are few things more annoying than 
always being taken to the start of a docu- 
ment after an editing session has been 
interrupted. When you Save a file, you are 
not asked whether or not you wish an 
existing file of the same name to be 
overwritten. 

This certainly makes the save process 
faster, but can lead to heartburn. The cur- 
rent file name is displayed in the menu area 
when you request a Save, so you can’t say 
you haven't been warned. It is not unusual 
to load a file of one name, modify it, then 
wish to save it under another name, and 
this is possible. In this case, you are asked 
| if you really want to overwrite any existing 
file of the same name. The chosen name 
then becomes the default for future saves. 
The programmer can't win here, as it ap- 
pears impossible to satisfy both types of 
user, without complicating life for all. 


Block commands 


Returning to the matter of speed, one 
area where Quill lets the user down badly 
is the copying or deleting of blocks of text. 
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T87 has no trouble with these operations, 
performing them quickly. The macro cursor 
movementcommand Go To has been made 
available within Block operations; although 
simply holding the cursor down gets you to 
another place quickly, it is helpful in long 
documents to be able to specify the page 
you wish to go to, when making a Copy or 
Move. The Search, and Replace, com- 
mands are performed similarly fast. Large 
documents do not appear to slow these 
commands down enough to bother about. 

The spell-checking function utilises a 
version of the Q_Typ checker written by 
Tony Tebby. Although this is a separate 
function, the user is only aware of this 
initially, when the word list is loaded. 
Checking is called from the editing screen 
and behaves as an integral part of T87. 
The method of operation is that generally 
used on PCs, with the current document 
being checked as in a Search operation, 
each unknown word causing a halt and 
presenting the user with a list of options, 
one of which has to be chosen to set the 
process going again. The checker stops at 
anything which is not matched by an entry 
in its own word list. 

The options are Ignore, Browse, Edit 
and Add To Word List. Choosing Ignore 
causes the checker to pass on to the next 
unknown word, without doing anything with 
the current one. Browse produces a list of 
words which begin with the same three 
characters as the unknown one; if one of 
those words happens to be what you ac- 
tually need in place of the unknown one, 
you move the highlight (a red box, as in the 
other T87 functions) to the word and press 
Enter, whereupon the unknown is replaced 
by your selection. You are then taken back 
to the edit screen, and you can make 
further changes if required (such as if the 
replacement word needs an ending adding 
to it). Esc starts the checking process go- 
ing again. Edit puts you in the same posi- 
tion as after Browse, to allow you to make 
your own changes to text. 


Free movement 


There doesn’t appear to be any limitation 
on editing; you can move the cursor off the 
current line and go up or down the docu- 
ment, which can occasionally be desirable 
(maybe you've just noticed something 
which needs changing a few lines back). 

‘Add’ does what would be expected, 
putting the current unknown word into a list 
which is supplementary to the main word 
list. The supplementary list as well as the 
main word list is checked for unknowns 
during the remainder of the current session, 
but the supplementary list is not saved 
automatically unfortunately. You must use 
the Save option of the F3-Config-Spelling 
menu to have your words recorded for 
future use; you must also use the Load 
option from the same menu - or the initial 
menu shown when spell-checking is se- 
lected - to have the supplementary list 


available during the next checking ses- 
sion. This seems unwieldy, but is perhaps 
preferable to using the separate editor 
program to incorporate word lists into the 
main word list file, which is the recom- 
mended method of dealing with supple- 
mentary word lists. It was this latter op- 
eration which put me off using the spell- 
checker with the earlier version of T87, so 
things are better now. 

There is no concurrent spell-checking 
function, but that shouldn't be missed by 
many users. As with many spell-checkers, 
upper case is inadequately deal with but, 
even so, it was surprising to find ‘germany’ 
accepted as correct, once ‘Germany’ had 
been added. One should bear in mind that 
the spell-checker is included in what would 
be a very reasonable price for the WP 
program alone; the checking performance 
is good enough to justify a much higher 
price, especially now the larger of the two 
word lists supplied is said to contain over 
200,000 words, and there are German and 
French lists as well as English, at no extra 
charge. 


The end of the Page 


The coming of hard disk, then the 3.2 MB 
floppy drive, brought with it the possibility 
of using sub-directories, a development for 
which most QL software was unprepared. 
Plus-4 supports the basic devices MDV, 
FLP, DEV, NET, RAM and WIN and inter- 
prets these letters followed by one digit and 
an underscore at the start of a file name as 
being a device name; that is, you can use 
DEV8_QUILL_ or such as a default stor- 
age device. 

A seemingly small thing like the end of a 
page can cause a surprising amount of 
discussion. The earlier T87 didn’t show the 
ends of pages unless you used the Go To 
Page command to force the display of red 
lines. Plus-4 is much more helpful, with 
three types of red line, for soft page breaks 
(where the program ends pages on the 
basis of the set page length), hard page 
breaks (where the user opts to end a page, 
regardless of length), and Section breaks; 
all are displayed automatically. The Sec- 
tion is a new concept for the QL, but is 
fundamental to the creation of many ref- 
erence documents. Books are frequently 
divided into sections which may well have 
their individual page-numbering se- 
quences. The simplest example is the first 
few pages - introduction, contents, ac- 
knowledgements, etc. They are not part of 
the main stream of the written text and 
should be numbered separately - i, ii, iii or 
similar. Page numbers can be printed au- 
tomatically, anywhere within a frame; a 
marker code is used to tell the program the 
desired position for the numbers. 

It is desirable to have all your ‘working 
conditions’ constant, and to have the cur- 
rent formats saved with a document. If the 
Ruler is displayed and the menu is at the 
bottom of the screen while you are editing 
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a document on one occasion, there is a fair 
chance that is how you will want the screen 
to appear the next time you load that docu- 
ment. More importantly, the positions of 
margins and tabs, the type of justification, 
text founts and attributes, and such should 
be preserved, along with the cursor posi- 
tion. The F3-Config-Save option allows 
you to set your defaults for having the Ruler 
display on or off, having the menu dis- 
played at top or bottom of the screen, the 
amount of Room allocated to the next 
document, and the Ruler settings (margins 
and tabs), but you must use the F3-Config- 
Driver-Save option to preserve settings 
which are related to the printer, such as the 
default Typestyle. 


View screens 


In the gap between the introduction of 
versions 3 and Plus-4, much has hap- 
pened in the PC world, and it is no longer 
sensible to say that T87 is far better at the 
business of WYSIWYG. The pseudo-op- 
erating system Windows on the PC has 
spawned a collection of wordprocessors 
which make a fair job of displaying founts in 
the correct sizes and shapes, and making 
it easy to select them (trouble-free these 
are not, however.) There is also good 
agreement between screen and paper 
appearance of text. 

You may feel the need to do some ex- 


perimenting, to get the on-screen founts to 
match those which are printed, reasonably 
well. When your printer is a laser or ink-jet 
type, the wide range of point sizes can be 
only approximately represented on the 
screen. Matching is much easier to do 
when you have a simple 9-pin DMP printer, 
with few founts. Apart from the screen 
appearance though, you don'thave to worry 
about the effects of changing typestyle, 
because the program knows what you have 
requested, and takes care of the changes 
at print time. 

The main area in which the screen does 
not mirror the printout, and can cause you 
to mess-up printouts, is in line spacing. 
There is an option which allows you to 
switch on or off representative spacing on 
the screen, but this does not affect what is 
sent to the printer; that is set manually, on 
the Ruler. If you switch from, say, 10-point 
to 18-point, you'd better change the Line 
Spacing setting to match, or you'll have 
lines printing over each other. 


Running a test 


To provide a general check on capabil- 
ity, a test document was created, with 
another program and on another type of 
computer. The size of the file was close to 
300 KB, andit consisted of nearly 50 pages 
of text. There was no pointin trying to retain 
formatting information, such as founts and 
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attributes, so the file was saved in ‘Generic 
WP’ format, which is similar to Ascii text (a 
blessing on its little head - Ed.). The file was 
then transferred to the QL by means of the 
XOver file-transfer program. Attempts to 
load it with earlier versions of Plus-4, using 
the File-Import-Ascii command were met 
with refusal, and no indication of why. 

From previous experience, itlooked likely 
the problem was lack of working memory 
space, and possible confirmation of this 
was given when the Merge command was 
tried, a ‘short of memory’ message being 
displayed. The old memory size command 
has been replaced by the Room com- 
mand, which is not the same thing; it 
specifies the amount of extra editing space 
available for the next document, not the 
total memory for the document. However, 
the program was quickly modified to fix this 
problem and Import of such documents is 
now both simple and fast. The way the text 
appeared on the screen was a real pleas- 
ure - nothing funny about it, no non-printing 
codes, everything formatted as per the 
current Layout and Ruler settings, and it 
took only a few seconds. 

Many users will want to load Quill files 
and/or old _T87 ones. The Quill DOC file 
chosen for checking was an old standby, 
nearly 300 KB in size with over 40,000 
words of text. Itloaded with no bother, from 
the F3-File-Import-Quill command. The text 
attributes - bold, superscript, etc. - and tab 
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This page is A4 Landscape, 
split into 4 columns, You 
could use a similar layout to 
produce a newsletter in AS 
size, with 2 pages of 2 
columns each printed across 
A4 sheets, By giving a little 
careful thought to page 
numbering, and turning the 
paper over to print on both 
sides, you can create a 
booklet by folding & stapling 
the sheets down the middle. 


The edit screen shows only 1 
column; successive columns 
are displayed one below the 
other. The new Print Preview 
function does show the 
columns correctly, though; it 
also shows the justification of 
the text, which is not always 
apparent in the edit view. 


There is a Gap function 
contained within the 
Columns option of Layout 
which allows you to put 
space at the middle of the 
page. As the gap has to be 
the same between every pair 
of columns, you can't set a 
decent space where the 
page will be folded without at 
the same time making the 
spacing between the pair of 
columns on each side rather 


too large. Its a pity 5 
columns aren't allowed, as 
that would enable the middle 
one to be left blank, but you 
could use 3 columns and 
settle for just 1 column on 
each AS page, using the 
middle one for separating the 
pages. 


There is another way of 
achieving the same result -- 
using Frames. The A4 
Landscape Layout could be 
used, but divided into 4 thin 
vertical frames. As frames 
can be placed where you 
want them, the spacing 
between one pair can be 
different from that between 
another pair. This approach 
should produce the better 
result, at the expense of 
taking longer, 


Even if you opt to use the 
Column option rather than 
Frame, you can still use the 
latter for any headers or 
footers you require, As the 
whole of the landscape A4 
sheet of paper is 1 page, as 
far as Text87 is concerned, 
but 2 in the context of the 
newsletter, you may have to 
create, say, 4 frames to take 
separate headers and 
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footers for each of the 2 A5 
pages on one side of a sheet 
of paper, 


Dont hesitate to use the 
Print Preview, frequently. It is 
quick to produce a display of 
the “cameo" pages (PC 
programs tend to be very 
slow at displaying previews). 
Whilst you cannot read any 
of the text, you can certainly 
see whether or not the 
general form of it is going to 
look sensible when printed. 


lf you want to be a bit 
fancier, draw some lines to 
separate the columns. 
Text87 doesnt have a line- 
draw function -- particularly 
not in the vertical direction -- 
but what about using the 
underline style with the 
Space Bar and printing lines 
across the page in Portrait 
mode? This could be done 
before or after printing the 
text. For a regular 
publication, a master 
document with the necessary 
divider lines on it could be 
saved and re-used as 
required. A master could be 
set up for the column 
settings, too. Although Plus-4 
lets you have = several 


Layouts in a document, you 
cant do that in this case, 
because the page size & 
orientation have to remain 
the same. You must reset 
the printer after the first run- 
through of the paper; it will 
have to be set to Portrait to 
print the lines, then 
Landscape to print the text, 
or vice versa. 


The preceding point brings 
up another, in connection 
with founts. Text87 does not 
itself have both portrait and 
landscape founts and your 
printer may not have the 
same range in landscape 
orientation that it has in 
portrait. You might have to 
settle for a choice of just 2 
founts in landscape mode. 


A way round this particular 
problem: is to use the 
Fountext88 graphics printer- 
driver, which sends text to a 
printer as a graphics image, 
making it irrelevant what 
founts the printer has or 
doesn't have, The founts 
printed this way are by no 
means as smooth as those 
that are built-into printers 
such as the Hewlett-Packard 
DeskJet or LaserJet, though. 
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markers are preserved, but the actual tab 
positions change if the Tabs set on the 
current Ruler differ from those set in the 
_DOC file. The _T87 file selected was 
about three years old, anda mere 14 KBin 
size; this seemed less than a serious test, 
so four other _T87 files of roughly the same 
size each were appended to the first one, 
using the F3-File-Merge-Ascii command. 
Again, the earlier version gave a problem 
here, but that was promptly sorted out and 
all went well, and speedily, with the current 
version. 


Ascii loading 


The file format for T87 and _T91 (the 
new type) files is not the same, and this is 
why the test files had to be treated as 
being Ascii. Formatting information and 
text attributes are preserved with files 
LOADed as _T87 files (but not with those 
subsequently MERGEd as Ascii files). A 
SuperBasic boot file was loaded with F3- 
File-Import-Ascii also; the only things to 
note here are that the default Ruler set- 
ting is for full justification, which is un- 
likely to be suitable for program files (or 
indeed for many users’ text files) and the 
margins need to be set wide enough for 
the maximum line length. 

Some users will be interested in load- 
ing Perfection files. The two files that 
were checked loaded without hesitation, 
and the text format was basically correct. 
It was necessary to increase the Room 
(editing space) value to load a large file. 
The main market for T87, as for Perfec- 
tion, is those users who are still clinging to 
Quill. You may well have to make layout, 
ruler and fount changes before, and pos- 
sibly after, loading any ‘alien’ file, and 
there is no great problem in doing so, but 
it may take a fair amount of time, as it 
does with many other programs. There 
are Normal and Paragraph options for 
loading non-T87 files - the equivalent of 
Quill’s By Line and By Paragraph op- 
tions. 

Memory-management is something 
no program seems to get fully right, 
from the user’s point of view, but the 
Qdos operating system is not exactly 
helpful to the application programmer 
in this respect. Many users will be 
aware of the way Quill solves the 
problem by grabbing all the memory it 
can find. You know where you stand 
with Quill! T87 has a more difficult 
task; apart from the fact that your 
documents may vary greatly in size, 
you may wish to load several docu- 
ments during the same session, and 
there is no way the program can an- 
ticipate the total memory requirement for all 
you wish to do. The Room command allows 
you to set the working space in memory, to 
some extent. As my first actions while doing 
this review came up against shortage of 
memory, it would have been nice to find an 
index in the instructions, with ‘Memory’ or 
‘Room’ listed. 


All in memory 


The on-screen help tells you that the 
Room you allocate is expansion space for 
the next file to be loaded, and will be 
added to that taken by any files already 
loaded. The current program version has 
additional information on the screen con- 
cerning this function, and - as mentioned 
above - the commands which are con- 
nected to the Room function now work 
appreciably better. The instructions are 
to be modified also, to give more guid- 
ance to the user, and to incorporate an 
index. One thing to bear in mind is that the 
whole of a file is in memory, rather than 
part of it being on disk as can happen with 
long Quill documents, and this means 
faster operation. 

Ithas been a plus-point of T87 for some 
time that certain printers can be used in 
their native modes, rather than being 
treated as simple, Epson-compatible 
types. The illustrations for my articles are 
printed on an Epson GQ-5000 laser 
printer. While using even only basic Cou- 
rier 10-pitch on a laser printer produces a 
big improvement in perceived print qual- 
ity over most dot-matrix printout, the dif- 
ference becomes much more marked 
when you can use other founts and sizes 
which may be built into the laser. In the 
case of the GQ, the supplied printer driver 
(not part of the basic T87 package) uses 
the scalable Times and Helvetica founts, 
albeit only at certain sizes. The range of 
sizes is good, from 6 to 72 points, in steps 
of 2 to up to 14-point. If your printer 
supports printing in landscape mode, Plus- 
4 allows you to do this. The Layout must 
have suitably-wide margins; even with 
standard one-inch margins, you can printa 
spreadsheet with 116 12-pitch characters 
across landscape A4 paper. As with the 
extended Layout function, this brings you 
closer to having DTP capability. 


Talking printers 


Getting your particular printer to co-oper- 
ate with a program has always been a 
major problem for users, and T87 attempts 
to ease this by giving a choice of 32 printer 
drivers in the basic package, plus other 
special ones available for 24-pin DMP 
printers, the HP DeskJet (covering LaserJet 
Il emulation also), and Epson lasers, at 
extra cost. Itis likely that most users will be 
able to find a suitable driver from those 
offered, and there is no need to get in- 
volved in any configuration procedure. 
Indeed, no provision is now made for any 
custom-tailoring, but anyone with special 
requirements can contact Software87 and 
ask if these can be met (don’t assume 
changes will be done for free, though). 

A feature that has gone missing is the 
visible fount/size code. You still have an 
indicator to show you what the current 


selection is, but the codes are no longer 
seen in the text. Printing codes in general 
are something which can easily arouse 
strong arguments; my own preference is 
to have as many codes as possible either 
always visible within the text or, prefer- 
ably, displayable only when the user wants 
them, but the average user is more likely 
to want them hidden all the time. 

Criticisms? They were relatively minor 
with the earlier versions and have almost 
all been dealt with by the E3 version. It 
has never been of interest to me to know 
what line within a document the cursor is 
on, but this is what is shown on the status 
line, initially; to satisfy this complaint, an 
option has been added to set the default 
line numbering to within-page or within- 
document. The lack of automatic saving 
and reloading of the supplementary word 
list for the spelling checker is an irritation, 
but not a great one. The handling of 
memory might confuse the user, but it 
may be partly caused by the unhelpful 
way Qdos manages memory, and the 
latest program version certainly makes it 
much less likely most users will need to 
change the Room value. 


Layouts and frames 


The setting-up of Layouts and Frames 
cannot be called intuitive operations; you 
really need to read the instructions sev- 
eral times and look at the samples pro- 
vided. Maybe the process cannot be sim- 
plified much, but it took me longer than it 
should have to get the hang of it. It 
would be useful to have some more 
flexibility in certain commands; on the 
other hand, a few less keypresses 
would be appreciated. There is, as 
yet, no advance on the previous 
graphics-import function (which was 
anyway provided by an add-on pro- 
gram), so that full DTP functionality is 
still some way off; the addition of the 
necessary features is a large job, and 
would justify a considerable price in- 
crease, whilst being of interest to only 
a limited section of the QL community. 
The comments made above about the 
on-screen representation of typestyles 
and line spacing should be viewed in 
comparison with what other QL pro- 
grams offer; as has been the case 
from the start, T87 has to be put into 
the DTP category in this one respect. 

Plus-4 is a big step forward from 
previous versions. You still have to 
work at using some functions, but the 
menu structure has been improved and 
more help is given now, both on-screen 
and in the instructions. The flexibility 
of document layout is much-increased, 
and the print preview takes the pro- 
gram into a more professional area. It 
is fast, with no operational problems 
apparent. Made for serious scribes 
who care what the printed output looks 
like. Good value for money. 
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OFTWARE FILE 
Cricket 
Secretary 


Wotzat? It’s John Shaw - trying to keep his 
speed down to the pace of a game of cricket! 


INFORMATION 

Program: Cricket Secretary. 
A suite of programs to enable 
the Secretary of a cricket club to 
maintain the batting and 
bowling averages of his club. 
Author: CB Storey, 
Supplier: Dilwyn Jones 
Computing 

41] Bros Emrys 

Tal y Bont 

Bangor 

Gwynnedd 

Price: £12.00 

May, 3.5 in or 5.25 in disks. 
Works on an unexpanded Q.L., 


owzat! Here is a program 
especially designed for 


cricket lovers. To those 

devotees of the most English of 
games, watching Is only half of 
the pleasure, The other half comes 
from writing down the scores, 
working out the batting Averages 
and then discussing them at length 
over a pint in the Local. 

CB Storey has now developed 
the perfect program that does all 
the hard work for you. This, of 
course, leaves much more time for 
the discussion afterwards. Here 
we have a suite of programs , 
suitable for use by a cricket Secre- 
tary or enthustast alike. All the 
statisucs are available once the 
data has been entered: 


Batting Averages 
Bowling Averages 
Best Bowling 
Dismissal Averages 


The program ts supplied with 
an erght-page Manual that leads 
you through every aspect of the 
inputting and dataretrieval system. 
I didn’t find that it flowed as well 
as some [ have read, and I ree- 
ommend that buyers read it 
through thoroughly a few times 
before entering lots of data. It is 
hot totally error-trapped, and a 
couple of times | crashed the pro- 
gram before I could save it on toa 
disk. This was duce to a little ambi- 


| guity in the instructions, 


The instructions start by telling 
you how to create the two disks 
required for the program to work. 
In fact. three are needed, one be- 
ing a blank formatted disk to put 
the compulsory backup on. Tf you 
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try and get away without one, the 
first crash occurs. Once you have 
followed the set-up instructions, 
you are left with a master disk 
containing all the files needed to 
run the main part of the program, 
anda Data disk that will hold your 
scores and averages. 

On running the program, you 
are asked which drives your mas- 
ter and data disks are on. Unfortu- 
nately, you have to do this every 
time you run the program. [ found 
this a little tedious, and would 
have preferred to have had this 
configured permanently. 

Then the Suite Menu appears: 


. Run Cricket Secretary 
. Run Printa 

. Run Toolkit 

. Quit 


You make your choice by 
pressing the appropriate number, 
You will then be asked for the 
suffix of the files you wish to 
process. On the first occasion this 
is _0. This uses a skeleton pro- 
gram that forms the basis of future 
files. When you come to save 
them, you add a suitable suffix 
suchas _som92 (Somerset 1992). 
You will eventually build up data 
files on the disk for every team or 
serics you are collating. 

That done, you are confronted 
by a menu offering the following 
choices: Input Batting, Input 
Bowling. Examine Batting Aver- 
ages: Examine Bowling Aver- 
ages; Examine Best Bowling: 
Examine Dismissal Analysis: 
Load new file/backup/return to 
menu. 

Input Batting 

On selecting this, you ure first 
asked for the name of the crick- 
eter. It is important that this is 
done inthe correct format, that is: 
Shaw JR. (Neither SHAW JR nor 


JR Shaw. You have been warned!) 


You then enter the number of 


runs scored. This ts followed by 
an alphabetical input representing 
how the player was dismissed, A 
table of entries is provided to as- 
sist with this. 

This sequence then repeats itself’ 
until you have entered all the 
batter's details. 

Input Bowling 

The principles are the same as 
for the Batting input. The number 
of Overs bowled is the first data to 
be entered. This is followed by the 
number of Maidens bowled, the 
number of Runs and finally the 
number of Wickets taken. The 
sequence then repeats itself, 

Batting Averages 

The batting data is computed to 
two decimal places and displayed 
in order of Average, the highest 
first. 

Bowling Averages 

These are computed to the same 
standard as the batting averages. 

Best Bowling 

This is a sub-set of the Bowling 
Average table, and comprises the 
Name. Runs per over, Balls per 
wicket and best Bowling. 

Dismissal Analysis 

This will show a table display- 
ing how many times cach batter 
has been dismissed and the method 
of dismissal. 


CRICKET SEC 


Load New File 

This is the compulsory Backup 
point. If you try to ignore the 
warning, you will crash and your 
data will be lost. Make sure you 
have a spare blank disk ready. 

Printa enables you to print out 
hard copies of the data you have 


just compiled. You are given the 


option of installing a new printer 
driver if you wish. The Toolkit 
allows you lo modify the database 
should you accidentally put in 
wrong detail. The author warns 
that you should take great care 
when using this facility. | agree! 

This is a good and extensive 
program that, however, needs to 
be handled a little carefully in order 
to avoid problems, I offer you 
these few tips: 


Have three blank disks ready at 
the beginning. 

Read the Manual a few times 
before you start using the pro- 
gram. 

Practice with asmall amount of 
input in order to become familiar 
with the program before you enter 
all your scores. 

Remember the way it requires 
you to enter the names, ie Brown 
GM. 

Always keep a straight bat! 


r 


SUITE NENU 


Copyright @ CB Storey, 1992 


» RUN CRLCRET SELAE TARY 


» RUM PRIA 


3. RUN TOOLKIT 


« WIT 


#44 Press the number you require 2h4 


23 


sures that all significant figures stay where they are put, which 
makes a worthwhile difference with calculations such as these. 

Having said that, even this reviewer's humble JS machine 
produced results which generally were closer to published 
predictions than the examples provided by the author, which 
were evidently run on an IBM micro. There is, however, much 


Cornucopia of 


Algorithms 


Practical 
Astrononiy With 
Your Calculator 
Peter Duffet- 
Smith 

£11.95 
Astronomy With 
Your Personal 
Computer 

Peter Duffet- 
Smith 

£15.95 
Cambridge 

u niversity Press 
Currently in 
print 

QL Specific: No 


Author: 


Price: 
Publisher: 


Available: 


ractical astronomy with 

your calculator is a cor- 

nucopia of algorithms 

for solving the often 
nightmarish calculations in- 
volved in astronomical math- 
ematics. Do not be misled by 
the title: included is everything, 
from relatively straightfor- 
ward data and time 
calculations and conversions 
between co-ordinate systems 
to calculating the effects of 
atmospheric refraction, and the 
positions of the sun, moon and 
planets with a degree of 
accuracy which will satisfy all 
but the most exacting require- 
ments. Times of the rising and 
setting of sun and moon, for 
example, can be found to 
within about a minute. 

The mathematics used is not 
only eminently suitable for a 
personal computer but, for re- 
peated calculations, makes one 
almost essential. Each section 
has not only a clear explana- 
tion of what is being done but 
at least one worked example. 

The related volume As- 
trononiy with your personal com- 
puter covers for the most part 
thesame ground, thoughalgo- 
rithms are given in a language 


not unlike microsoft basic in- 
stead of step-by-step calcula- 
tion. This translates easily to 
the OL’s SuperBasic, the more 
so as the superbasic functions 
RAD, DEG, ASIN and ACOS 
can replace the more rounda- 
bout methods which Duffett- 
Smith uses in order to maxim- 
ise the compatibility between 
dialects. In addition his 
modular approach lends well 
to the building of a library of 
superbasic procedures and 
functions which can be merged 
as appropriate for particular 
applications. 

A number of the algorithms 
— particularly those which cal- 
culate the positions of the sun, 
moon and planets — differ sub- 
stantially from the companion 
volume in being more accurate 
still, albeit at the inevitable 
expense of more typing-in and 
less speed in execution. (Find- 
ing, the instantaneous position 
of the moon, for example re- 
quires 99 SIN and 32 COS cal- 
culations, even before the re- 
sults have been worked into a 
useful format.) 

One intriguing extra section 
provides a method of deriving 
acomet’s orbital elements from 
visual observations: these can 
then be used to predict its fu- 
ture path. 

A problem with SuperBasic 
which both of these books 
highlight is that of the numeri- 
calaccuracy of constants. It will 
often be necessary to use 
something like e=’23.441893’ 
(with quotes) as otherwise 
SuperBasic will store any 
eighth and ninth digits inter- 
nally only to lose them again if 
the line is subsequently edited 
or the program saved and re- 
loaded. Entering constants as 
strings (which the system co- 
erces to floating-pointnumbers 
when they are allocated) en- 


Available: 


scope here for putting to practical use the accelerated maths 
routines of the Minerva rom or the Lightning maths extensions. 

Not only astronomers but anyone with an interest in simply | 
playing with mathematics will find enough in these splendid 
books to keep them occupied for hours. 


Hilary Snaden 


A Valuable 
Reference Manual 


QL Advanced 
User Guide 
Adrian Dickens 
Adder Publishing 
£12.95 

Fairs, second- 
hand 


QL Specific: Yes 


he QL Advanced User 

Guide is described, on 

its back cover as ‘the 

authoritative guide to the 
Sinclair QL System’. The descrip- 
tion finishes with the statement 
‘No programmer of the QL can 
consider not owning a copy of this 
invaluable reference manual’. | 
could find little in the book to 
cause me to disagree with these 
statements — It contains a great 
deal of very useful information. 
However the back cover also 
claims that the book ‘assumes no 
previous knowledge of operating 
systems or 68000 assembler’ — 
something [ would hesitate to ac- 
cept. 


The Guide is made up largely of 


a comprehensive list of the func- 
lions that the QL"s inbuilt soft- 
ware, Qdos, provides for writers 
of machine code programs, These 
functions cover nearly any action 
that the QL may be seen doing, 
from saving data to printing to 
screen. By accessing them directly 
in machine code, full control can 


be gained over multitasking and 
similar internal functions of the 
machine, Lach funetion is de- 
scribed, along with the methods 
used to invoke il, responses that 
may be given and parameters 
needed to be sent. 

This list is preeeded by a short 
introduction to QL. machine code, 
an overview of Qdos and a listing 
of an experimentor which allows 
Qdos functions to be tried from 
Basic. For those new to machine 
code the troduction is, to my 
mind al least, too short to be easily 
understood. I feel therefore that 
the book cannot claim to assume 
no knowledge of assembler — but 
for those who know at least the 
basics it is excellent. 

To demonstrate the uses of 
Qdos, the overview includes two 
assembler listings —one foraclock 
that displays the time permanently 
on screen and another for a set of 
rapidly reproducing, multitasking 
blobs that rush across the screen. 
Later listings show how to add 
procedures to Basic in machine 
code, how to control the QL’s 
under-used two screen facility and 
provide adevice driver fora paral- 
lel printer port. 

Following the list of Qdos 
functions, the QL device drivers 
are described, as well as internal 
formats for most information used 
by the operating system. Finally, 
the machine code interface to Ba- 
sic Is examined, 
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This thorough deseription of the QL’s internal workings is comple- 
mented by twenty appendices that cover additional details of the 
machine, from its memory map to hardware expansion information. 
These are very useful in their own right — even including a circuit 
diagram for a printer interface to match the device driver documented 
earlier. The book is completed by a bibliography, a glossary and full 
index. Certainly no QL programmer ought to be without this guide, 


Andrew Toone 


Integration of 
Machine Code 
and Electronics 


Computer 
Interfacing — 
Connection to the 
Real World 
Martin Cripps 
Edward Arnold, 
Hodder and 
Stoughton Ltd 
Price: £/2,95 
Available: | Currently in print 
QL Specifie: No 


Author: 
Publisher; 


artin Cripps, as the 

reader of this book 

will be quick to find 

oul, 1S nol satisfied. 
He is not satisfied with the current 
state of computer interfacing. Asa 
Director of the Wolfson Micro- 
processor Unit and a Senior Lec- 
turer at Imperial College, he has 
greater qualification to comment 
on these matters than most. In 
Computer Interfacing he sets out 
to explain his reasons for being 
unimpressed with the way in which 
we link our computers to their 
environment and, more impor- 
tantly, ways in which those links 
can be improved. 

Computer Interfacing was writ- 
ten {0 support courses presented 
to final year undergraduate stu- 
dents in computing, and as such 
contains some fairly complex ex- 
planations involving for instance, 
integration, machine code and 
electronics. 

These are used as tools to de- 
scribe through the book the way in 
which information is taken from 
external stimuli into the computer 
and the corresponding path for 
data from the computer to influ- 
ence the real world. 

This description is well defined 
as stages in the flow of informa- 
tion, Sensors are discussed, then 
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the sampling of data so as to accu- 
rately record an input waveform. 
Signal conditioning is explained 
before methods of digital to ana- 
logue and analogue to digital con- 
version; following these, the book 
goes on to cover the digital links to 
and between computers before 
standard interfaces are discussed, 
The pathway from real world to 
computer and back again is com- 
pleted by a section on output 
transducers, 

After these sections, Cripps 
rounds his subject by covering en- 
vironmental constraints such as 
noise and power supply: micro- 
processor input-output; integrated 
interfaces (interfaces on a single 
chip); microprocessor architecture 
and design techniques, finishing 
with three design examples. The 
design examples perhaps best in- 
dicate the area in which Computer 
Interfacing is most useful. A gas- 
plasma display, automated green- 
house and a mobile robot are de- 
scribed in terms of the design de- 
cisions that would be taken to im- 
plementthem. By stepping through 
the stages of interfacing the real 
world to microprocessors, the book 
covers all of the details involved 
in implementing any small mi- 
croprocessor based system, from 
sophisticated engine management 
system to multiprocessing com- 
puter. 

The book is well thought out 
and written in an informal style 
that lightens this otherwise com- 
plex subject. For anyone inter- 
ested in computer hardware 
therefore, at a little under thirteen 
pounds it is a good value read — 
however, being written for fairly 
advanced students, some know!- 
edge of the subjects involved is 
vital. 

Nigel Bates 


Drive Further than 
than Corner 


Developing Appli- 
cations on the 
Sinclair OL — Prac 
tical Ideas for 
Home and Business 
Use 

Mike Grace 
Sunshine Books 
(Scot Press}, 1984 
£6.95 in 1985 

At fairs or second- 
hand 

OL Specific: Yes 


Author: 
Publisher: 


Price: 
Available: 


you've never be 

lieved that using a 

computer was meant 

to be fun as well 
asproductive then Mike Grace’s 
infectious enthusiasm for the QL 
and the bundled software might 
just change your mind. 

Grace stresses that it’s no good 
having powerful software unless 
you understand how that software 
works, and more importantly, how 
to apply it. Otherwise, it’s rather 
like using a Ferrari to drive around 
to the corner-shop for a pint of 
milk. 

Having said that, I must take the 
author to task for his misleading 
uule. The book is concerned only 
with the Psion software and makes 
no reference to SuperBasic. Also, 
to judge by the examples he pro- 
vides for cach of the Psion pack- 
ages, there is a very wide spectrum 
of meaning to his use of the word 
‘application’. 

Grace rightly points out that the 
strength of the Psion software is 
that you can usc It straight away 
without the tedium of learning to 
program. He lists a whole range of 
possible uses for students, home- 
users, Club secretaries, part-time 
businesses and self-employed 
people — in short, anyone with a 
QL, although he does caution that 
some things are better done on 
paper than on computer. The em- 
phatic message 1s: QL computing 
is for you! 

The book is divided into five 
sections covering a general intro- 
duction to the QL and Psion soft- 
ware and cach of the bundled soft- 
ware packages Quill, Abacus, 
Archive, and Easel. Grace relies 
on the reader to cross-reference 
with the User Guide - the main 
weakness of his book — and he 


does not attempt a comprehensive 
description of all the commands. 

The longest section deals with 
Quill where the author encour- 
ages flairand creativity rather than 
viewing it merely as a kind of 
electronic typewriter. His account 
is comprehensive enough to enable 
the reader to use it effectively. 
However, the text needs to be read 
with the improvements of Version 
2.35 in mind. 

The section of Abacus is thorough | 
and stimulating with interesting 
comments on the User Guide exam- 
ples together with several of his own 
applications. There is a useful table 
of the most commonly-encountered 
Abacus commands and functions, 
and an illustration of the use of sev- 
eral of the more esoteric ones such as 
ave( ) and if( ). However, Grace's 
diary/schedule-planner application is 
agoodexample of his own injunction 
that some things are better done on 
paper! 

The section of Archive covers 
most of the commands and fune- 
tions, illustrated by some simple 
database applications. His advice 
on the opening and closing of Ar- 
chive files is misleading as data- 
base files are always at risk while | 
they are open (as opposed to being 
looked at) even if they have been 
closed at some previous time, 
Grace does a particularly effective 
bit of soap-box shouting at the end 
of this section on how really good 
a computer the QI. is. Unfortu- 
nately, the book starts to thin cut a 
good deal from this point on. 

Grace, like most other people, 
raves over Easel and what he calls 
its incredible flexibility, but you'll 
need to study the User Guide in 
much more detail than forthe other 
Psion packages to get the full 
benefit of this. 

Atthe end of the book, there is a 


- glossary of both general and QL- 


specific jargon terms followed by 
a summary of chapter contents. 
Overall, there are few niggles with 
a book which is clearly laid out 
and written in a fresh and 
unpatronising style, For anyone 
who has not dared to think big 
with their Psion software or finds 
the User Guide too daunting, then 
] would recommend getting your 
hands on it. 


Nigel Bates 


$ FIWARE FILE 


INFORMATION 

Program: MicroEmacs text editor, 
recompiled. 

Supplier: QubbeSoft and CGH public 
domain libraries 

Price and format: Sce individual 
suppliers 


icroEmucs must be one of the longest- 
running sagas in the history of comput 

ing. Its origins lic in the pre-home com 

puting days ofthe 1970s in the corridors 

of the Massachusetts Institute of Technology 
(MIT), where it was designed as a rough-and- 
ready text editor which could without too much 
difficulty be ported between different machines. 
To this end it was written in C, the idea being 
that any machine with the basic hardware re- 
quirements which was capable of compiling 


the source code should also be capable of 


running the program, 

The earliest versions were fairly basic, de- 
signed as a somewhat rudimentary aid to pro- 
gramming in C, but subsequent authors, most 
notably Daniel M Lawrence, together with a 
host of other programmers who have contrib- 
uted bits of code along the way, have made 
MicroEmacs into one of the most sophisticated 
text editors available anywhere, 

Most of the work in getting the program to 
work on the QL was done by Ken Norrie, who 
released a compilation with Lattice C of version 
3.9p of the source code. More latterly, a number 
of minor bugs have been ironed out by Richard 
Kettlewell, and the code recompiled using the 
later and considerably improved C68 compiler. 
The result is a considerable increase in speed, 
though sereen handling, the QL’s perpetual 
Achilles” heel, is still somewhat slower than 
that of programs more painstakingly custom- 
ised for the QL. So flexible is MicroEmacs, 
however, that it is possible to speed up the 
sereen by altering the vertical and horizontal 
and vertical scrolling rates - in cffect, by 
configuring a ‘lazy screen’, 

For example: 


set $hscroll FALSE 


will ensure that only the cursor line is panned 
rather than the whole screen, while 


set $hjump 8 


forces it to pan eight characters at atime. The 
difference these make ts dramatic. 


Hilary Snaden tries the long-running MicroKmacs 
text editor, as updated and recompiled with the C68 
C compiler. 


Slow screen 


However, while the problematic colour 
modes now work after a fashion, changing 
from the default valucs seems to have the 
unfortunate effect of considerably slowing 
screen handling. However, the startup con- 
figuration of white text on a black background 
with a green mode line will probably be ac- 
ceptable to most users, and it may well be that 
this minor bug will be fixed in future releases. 

An advantage which MicroEmacs shares 
with the best QL software is that it multitasks 
from Basic with neither problems nor any need 
for fiddly extensions to SuperBasic. Indeed, 
since like Digital Precision’s Editor it has no 
inbuilt directory facilities, multitasking via 
EXEC or EX is essential to make available 
SuperBasic’s DIR command. The program code 
is fairly lengthy, but at some 98K it is only 
marginally longer than Editor, but with more to 
offeras a text editor; however, itshould perhaps 
be stressed that MicroEmacs is not a 
wordprocessor. Most importantly, it has no 
facilities for driving printers. 

It does have a number of functions rarely 
found in the most sophisticated of 
wordprocessors, and it is a relatively straight- 
forward matter to insert control codes from 
chr$(0) to chrS(26) from the keyboard, so with 
some work the more common printer control 
strings can be embedded in the text. 

Besides some standard wordprocessor-type 
functions such as fill-paragraph and set-fill- 
column (analagous to setting the right margin) 
there are some surprising extras. For example 
Ctrl-T swaps the character under the cursor 
with its nextdoor neighbour (Uf only more 
wordprocessors had that facility), presumably 
this was added by a programmer whose fingers, 
like those of many keyboard users, have mis- 
chicyous minds of their own (or one who can 
never quite remember the rules about Is and 
Es). 

It is also possible to convert spaces to tabs- 
and-spaces and vice versa; this can lead to a 
surprising saving in disk space with files con- 
taining data tables, or with a good deal of 
indenting suchas C programs, and MicroEmacs 
can encrypt files so that your program or text 


file is inaccessible without the ‘password’ used 
as an encryption key, 


Word count 


There are inbuilt functions for conyerting 
words or blocks of text to upper or lower case, 
and included in the count-words function is a 
display of average word length, useful as a 
check on writers inclined to verbosity or for 
those uncertain whether to send their latest 
work to the Financial Times or the Sun. This 
review, lor example, averages 5.81 characters 
per word. Readers of QL World can make of 
that what they will. 

An aspect of using the program which ts a 
little confusing to begin with but which soon 
becomes a revelation is that Enter does not end 
a search or replace a prompt but adds <NL> to 
it. (The prompts are in fact terminated with 
ESCape.) This means that strings at the end or 
the beginning of a line can be specifically 
searched for, and double blank lines can easily 
be replaced by single. This is so useful it is 
surprising that authors of other editors have not 
tried to come up with something similar. 

Any recognised combination of keys can be 
redefined to execute any of MicroEmacs’ ex- 
isting commands; hence, if you find yourself 
using some of the more obscure commands 
relatively often, you can bind them to a more 
convenient keystroke. The combinations 
available are Ctrl-(character), ESC+(character) 
and ESC+Ctrl-(character), leaving plenty of 
room for customisations. You can even rede- 
fine single keys, though this obviously needs to 
be done with some care! 

In addition to the standard key bindings 
common to all versions of MicroEmacs (so, for 
example, should you have access to the same 
program on a Wax mainframe, Ctrl-N will goto- 
next-line just as you are used to), the more usual 
cursor movements have been bound to the 
QL’s cursor keys in such a way that they 
behave much as they do in Quiff and the like. 

Any deletions larger than single characters 
can be undone, since the deleted text is kept in 
a ‘kill buffer’ until the next major deletion. This 
is also how blocks of text are moved around. 

Particularly astonishing is the speed of the 
replace-string command: presumably this 1s 
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largely because the screen is not updated each 
time a substitution occurs unless query-replace- 
string has been called. 


By name 


While all of the most commonly-used com- 
mands are already bound toshort key sequences, 
all of those available can also be invoked by 
name - though one has first to know that ESC- 
X brings up the ‘execute-named-command’ 
command! Even this can be made to look 
something like Quill and most other QL text- 
handling software by binding the command to 
the F3 key with the line 

bind-to-key execute-named-command FNO, 

This and any other program configurations 
can also be saved in a file called emacs_re, 
which will then be read and set up when the 
program is first started. As a practical example 
of this, Qdos traps Ctrl-C before itever reaches 
MicroEmacs, and so the count-words command 
will not initially be available from simple 
keystrokes. It can be made so by the line: 


bind-to-key count-words M-H 


which uses the otherwise unused combina- 
tion ESC-H. 

If you can’t remember the name of the 
command you want, MicroEmacs can produce 
acomplete or selective list, or lyping a space at 
the prompt will fill in the name up to the next 
ambiguity. 

Almost every aspect of the workings of 
MicroEmacs can be altered from within the 
program; there is, for example, an automatic 
Save facility which initially resaves the file 
being edited every 256 characters. but this 
count can be set by the user, A perhaps incon- 
venient but quite understandable exception is 
program dataspace, which must be set either at 
compile-time or with a command line such as: 

EX flpl_emaes;"% 122880" 

which will set the dataspace to 120K. Note 
that you need QJump’s Toolkit 2, or some other 
enhanced EXEC command to do this, otherwise 
the default of 64K will be used, The current 
version of MicroEmacs will, therefore, just fit 
in a 256K machine. MicroEmacs will work 
with less dataspace, but al a noticeably lower 
speed. As with other programs, though, if little 
headroom in terms of ram is left, disk access 
will be slowed as Qdos will have little space 
available in which to set up slave blocks. 


Windows 


One of the most interesting of MicroEmacs’ 
features 1s that it is possible to work on several 
different files concurrently, and to divide the 
screen horizontally into a number of windows 
which may display different files or different 
parts of the same file. However, if the sume 
portion of text is displayed in two windows, 
screen handling can no longer keep up with 
with even an average typing speed, though it 
seems to catch up eventually. 
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The buffers used for each file can have the 
main editing modes (for example, overwrite, 
automatic word-wrap and case-dependent 
searching) set independently of the others. 
Moving text from one buffer to another is quite 
straightforward. 

Potentially the most powerful of 
MicroEmacs’ facilities is the macro language. 
This works something like Editor’s command 
files but ina far more sophisticated and flexible 
fashion: not only are the inbuilt text manipula- 
tion procedures available but there are a number 
of mathematical and logical functions and 
structures, so that a complete macro may end 
up looking like an Archive program. The 
‘programs’ can be invoked from disk or a text 
buffer, or can be built into MicroEmacs as a 
numbered macro or named procedure. As a 
relatively unsophisticated example of what can 
be done, the listing shows a procedure which 
(after a fashion) renumbers a SuperBasic pro- 
gram file. 

Would-be programmers should beware of 
the pitfall that MicroEmacs does not recognise 
the abort-command keying (Ctrl-G) when it is 
in the middle of a while construct, unless it has 
been specifically programmed in, as in the 
example, This should really have been men- 
tioned in the documentation, as it is so casy, 
even witha macro debug facility. toend up with 
a perpetual loop, particularly while developing 
applications. 


SOFTWARE FILE 


Source code 


The public domain disks include the com- 
plete source code (about 475K of it) and a 
further 182K of documentation comprising a 
users’ manual. alearn-as-you-go tutorial, anda 
file which, while originally intended to provide 
on-screen help, may be usefully printed out as 
a crib sheet. 

If you are familiar with C and have a suitable 
compiler (the C68 compiler with which the 
current ready-to-run version of MicroEmacs 
was prepared is also available in the public 
domain) you can even hack around the original 
code to produce your own customised edition 
apart from the configuration that can be done 
from within the program itself, Since the source 
is likely to remain under development for the 
forseeable future, and itis in the public domain, 
there is litthe chance of users being left with 
abandoned software. 

Given the amount of man- and woman-hours 
which have gone into programming 
MicroEmacs. and the range of facilities it has to 
offer, it must represent one of the best value 
programs ever. 

MicroEmacs is available from CGH Services 
and QubbeSolt public domain libraries. Atthe ime 
of writing the new C68-compiled version had not 
percolated through tothe Quanta members’ library. 
For those who wish to experiment further the C68 
compiler may be obtained from the same sources. 


Example MicroEmacs procedure 


store-procedure m 


; line-number a region 


narrow-lo-region 
end-of-file 

set %lines $curline 
beginning-of-file 


set %newnum @”Start number: * 
set Zinc @” Increment: * 
write-message ““Renumbering...” 
'while &les Scurline %lines 


‘if Spending 


set Ya &asc &gtk 

lif &equ %a 7 
write-message “[ Aborted]” 
widen-from-region 
'return 


fendif 
endif 


beginning-of-line 


search-forward 


se oe 


delete-previous-word 
insert-string Yonewnum 


insert-space 


set %newnum &add Y%newnum Vince 


next-line 
fendwhile 
widen-from-region 


write-message “Renumbered!” 


‘endm 


You may prefer to use monochrome 
icons 16 pixels square, taking 40 bytes each, 
and SET_RED 1 to highlight one, changing a 
green on black image to white on red. These 
file sizes exclude the ALCHP heap overhead 


of 20-27 bytes per allocation. 

With DIY icons and window control, 
you are well on the way to a complete 
‘WIMP’ system of Windows, Icons, Menus 


and Pointers. The missing bits can simply 
be hacked together in SuperBasic, but you 
may prefer to use ready-made compo- 
nents, such as Qmenu from Jochen Merz. 
Tony Tebby’s pointer interface provides a 


standard way to read mice, joysticks or the 


Part two keyboard; it appears on Quanta library 


disk Specials 0. 


Simon Goodwin Sava ane 


« 


wraps up his QL setred bsres ert Chraritigst Read channel number 


subq.w #2,d35 Check parameter count 


» Hagét Llshet veLlear -IeUnopy to red bytes Ff 


. . . bores bad par am? THO free aor preee tered 
windowing project move. vi 2lat,a6.1),dé Fetch the flag 
; hares find window 
2 tst.w dé 
begun in last bells ped lites Copy green bytes te red 
addq. 1 #1,a4 Point at odd (red) bytes 
month’s QL World check pat beq-s #ill_lines If Dé=4, leave it alone 
. moveg W-l dé Otherwise, set all bits 
fill_lines lea.l Ffill_bytes,a3S Put D& tn alternate bytes 
bra.s scan_lines 
red_lines lea.l red_bytes,a3 Point at mext line 


the lastissue, DIY Toolkitin | Bre-§ Bean ines 


* 


troduced seven new keywords bad param moved gee ' BAD PARAMETER er ror 
: ras quick exi 
which allow QL programs to chan_error  maveq #-6,d0 CHANNEL NOT DPEN errar 
quick_exit addq.1 #4,a7 Tidy the return stack 


save, compress and restore eS 
overlapping windows. This * 


‘ 4 * SET_GREEN #ch% , flag% (Ci=Set @=Clear —-1=Copy to gr mien bytes tl 
article presents the remainder of the as- * 


setqreen bsr.s get channel Read channel number 


sembler source for these keywords, ex- Saba. W #2,d3 Check garcmeber colin’ 
plains their inner workings, and discusses Eie-= bad_param2 ER SOS Seow 


ie . myer. i 2lal,ao 1,56 
further applications of the code. bsr.s find window 


tral iw dé 


If you missed the last issue, or do bpl.s check pak Seb of clear even bykes 
not wish to re-type my listings, you can acheliy. 1 #llad Start wath the red byte 


lea.l green_bytes,aS Point at byte copier 


obtain complete source and object code bra.s scan lines 
* 


for Volume W, DIY Windows, on disk or * FIND WINDOW — locates window details from channel detain) tion 
microdrive cartridge, with documentation find_window lea.1 window ext,a2 Point AZ at EXTOP ¢ ode 


| and extra example programs. Write to DIY aover ds Wait indefinitely long 
Toolkit at Cwm Gwen Hall, Pencader, ae : call via Qian 


Dyfed, Cymru SA39 9HA, or call 0559 tst.1 ( Z signals ERR.DK 


bone. s quick Return error directly 
384574. move.w di,d& DG is window Line cout 
mower. F ai,d4a Preserve width & height 


Send a stamped self-addressed aay) * aees Preserve: eidth: & hess 
envelope for details of the volumes cur- swap at Recover line width 


mulu da,di Compute storage needs 


rently available. DIY Toolkit Volumes cost tst.w és Ore we crunching? 
£3 each, plus £4 per order to cover disks Sooo, ao uate wdute Ronee 
and processing costs. If youhave nodisk | Ee ea et Aen ebetena yer tg 
drive please enclose one cartridge for move. 1 di,d5 Preserve size needed 

. d4 
each volume required. ee eT finda Aizu sisi 
isr.w #1,00 Count words nat bytes 
Icons for Qdos a ae Adjust for DBRA later 
subg w Ht.d4 Adjust for DBRA 
rts 


Kelurn subroutine errors 


The window routines can be used to : 
display and highlight small pictures, or bad range moveq #-4,40 OUT OF RANGE error code 
‘icons’, on the QL screen. These may be bad_param? came #-15,d@ RAD PARAMETER error code 
stored on disk and displayed with a short ee res ; 
SuperBasic loader. You can design these * W_SHOW Hch% , base_address Re-displays stored windows 
with programs like GraphicQL, The shen re ee BEA 5 Gd ade eb eeaen 
Painter or Eye-Q, and extract them from a Sees igmee- oC oe 
screen image file with W_STORE or side! ey Pargst the. Firat for nem 
W CRUNCH. movea-) Bo oe Retrieve parameter 2 

Itis convenient to use positions and Serer meetin as Gar GATN Gel ah Leseer 
widths that are an exact multiple of eight ist ta 
pixels, such as 16, 24 or 32 pixels. 
Monochrome 32 by 32 pixel icons occupy 
1/128th of the screen, and use 136 bytes 
each; four colour 16 by 16 pixel icons 


weigh in at 72 bytes. 
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Code commentary 


The first part of the source code for 
DIY Windows appeared in the previous 
DIY Toolkitcolumn. The remainder is listed 
this month, with notes on the overall de- 
sign. | shall start by discussing the first 
part, so you may like to refer to Listing one 
from last month’s QL World. 

The window routines have many 
common features: they all take a window 
as a parameter and scan through the 
corresponding area of QL display memory. 
Itfollows that much code is shared between 
the keywords, and you need to understand 
the whole in order to make sense of the 
parts. After the usual snippet to introduce 
the new commands and functions to 
SuperBasic, the code begins by fetching 
parameters for W_CRUNCH, the function 
which stores a window in compressed 
form. 

Much of the code for W_CRUNCH is 
shared by the next command, W_STORE. 
The distinguishing feature is the value in 
register D6, which records the way the 
image is to be compressed. W_STORE 
sets D6 to zero, indicating that both red 
and green bytes are to be stored. 
W_CRUNCH copies its second parameter 
to D6; this is a QL colour-code: two for red 
or four to store only green bytes. 

Both functions use the subroutine 
GET_CHANNEL to fetch parameters. This 
evaluates all the parameters as integers, 
using the CA.GTINT vector, which leaves 
the number of values found in register D3. 
W_STORE checks for a single parameter, 
the channel number. W_CRUNCH also 
expects the compression indicator, so it 
reports a ‘bad parameter’ error if D3 is not 
setto two after the calltoGET_CHANNEL. 

Both these extensions return a value, 
so it is important not to leave unwanted 
values on the maths stack, where they 
might get in the way of the result. 
GET_CHANNEL tidies the stack with 
ADDQ.L #2,$58(A6) after reading the Basic 
channel number, and returns with the 
corresponding Qdos channel! ID in AQ. 
W_CRUNCH uses the same instruction to 
unstack the compression indicator. 

GET_CHANNEL checks for several 
potential errors and returns directly to the 
SuperBasic interpreter with an error code 
in DO if a problem is found. The code at 
QUICK_EXIT discards the subroutine re- 
turn address so there is no need to check 
DO after each call to GET_CHANNEL. 
They only return if all went well. 


Overflow report 


GET CHANNEL reports ‘overflow’ 
or ‘error in expression’ if the parameter is 
not a valid integer, and ‘bad parameter’ if 
itis negative. It signals ‘channel not open’ 
if the channel has been closed or never 
opened. 

W_STORE and W_CRUNCH share 
code from SAVE_WINDOW onwards. First 
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DIY TOOLKIT 


byte_lines 


word lings 


be. a 
move. 
bini.s 
btst 

bne.s 


the buf fer 


moves. 1 
move.w 
beris 
movea.1 
addq.} 
cmp. 
bre. s 
Cop. 
boner 
addq.1 
subq.w 
bmi.s 
bne.s 
addq.1l 
lea.l 
bra 
lea.1l 
bra 


+ 
* Find SCR BASE (A)-L} 
* 


window ext 


* 


moveq 
cmp.1 
beq 
move.w 
ler.w 
hele 


moved. I 
acct sa. we 
move. bi 
mula 
adda, 


moveq 
add.w 
attd — we 
lsrew 
belr 

sub. Ww 


Shipp 
move. vw 
moaveq 
rts 


exit2 
Glal,ab-1),d7 
bad_param2 
80,47 
bad_param2 


baue address and A® ic the channel ID 


d7,a2 
1M(a2>,d& 
find _window 
d?7, ad 

#4, ad 
(a®)+,d5 

bad tange 
fam)+,d4 

bad range 

H2 a 

#2,d6 

word lanes 
byte_lines 
Wllat 

load bytes, a3 
scan_lines 
load words,aS 
scan _lings 


LINE WIOTH% (D1-H) LINE COUNTY (D1.W) 


#48, 06 
{aP),dd 
bad param2 
24 4a), da 
#2,d9 

#0, ue 


5B laB) sad 
d@, al 

26 (am), dd 
#128,d1 
di,al 


#6,d1 
24(a@),d1 
28 (a) dh 
Wt, dt 
#0,d1 
da, cl 


di 
3A (aA) ,di 
#4, 4aa 


* Line scanning routines, used by JSR 


* 
save_bytes 


* 
#ill_bytes 


move.b 
addq.1) 
Obra 
rts 


move.b 
addq.1 
dibr a 
rts 


green_bytes move.b 


” 
red bytes 


« 
load_bytes 


* 
load_wor ds 


Sawe words 


addq.1 
dbra 
rts 


move. b 
dbra 
rts 


move.b 
addy.} 
dbra 
res 


AVES 
dora 
PKS: 


move.b 
move.b 
move.b 
dbra 
rts 


move. 
dbra 
rts 


(ad) +, (agit 
#1,a4 
d2,5ave_bytes 


d&, (aa) 
#2,a4 
d2,#i1)_bytes 


(aa) ,—(a4) 
#3,a4 
d2,green_bytes 


ladd+, (add+ 
d2,red_bytes 


ia@)+, (adit 
#i,a4 
a?, load_bytes 


tamr+, (adr+ 
d2,load words 


(aa+,d1 
fa4),-1 (a4) 
di, (a4)+ 
d2,4wap_words 


Cadi, Camis 
o2,save words 


Return D@ error code 
Pick up the base address 
Tt should be posrtrve 
and even 


AZ —> RAM butter 
Check compression flay 


AB ~> RAM buffer 
Skip the ALCHP link 
Cheek total space used 


Check line count 


Skip (lwe CRUNCH flag now 
Check the CRUNCH #lag 

Tf <?, restore hath bytes 
>2, set green bytes only 
Point at first red byte 


Preset MEM Length 
Check this channel 
Reject MEM definitions 
Fetch margin in pixels 
Divide by 4 

Make even word offset 


Localw the screen start 
Adjust for left margin 
Fetoh top margin 

Scale for 128 bytes/line 
At —> tiest window word 


Round (6 word boundaries 
Allow for left margin 
Allow for width 

Divide width by 4 

Make word offset even 

Dl im line width in bytes 


Put byte width in DL.H 

Put line count in DLL 

Indicate no error 

(AS) in SCAN LINES 

Copy from screen to RAM 


Skip the other byte 
Repeat for entire bine 


Copy pattern to byte 


Advance to next word 


Copy red byte ta green 
Point at next red byte 


Copy a green byte to red 


Copy from heap to screen 
Skip the other byte 


Copy fran RAM to screen 


Fetch green byte 
Copy red ta Qh een 
Store green over red 


Copy From screen to RAM 


\ 


they call FIND_ WINDOW to read details 
into registers from the channel definition of 
the window. Thisinturncalls an SD.EXTOP 
extended operation routine, which tempo- 
rarily replaces the channel ID in AO with the 
address of the channel details. SD.EXTOP 
sifts out non-display channels, reporting 
‘bad parameter’. 

The FIND_WINDOW subroutine 
works out the location and storage re- 
quirements for the window. By the time it 
has finished, A1 points to the first word of 
the window in display memory, the amount 
of space needed is in registers D1 and D5, 
with the width of each window line in DO 
and the number of lines in D4. 

The width is measured in sixteen bit 
words, with one subtracted from DO and D4 
to suit the DBRA loop instruction, which 
counts down from the initial value to -1. 
This fiddling around is justified because it 
simplifies the keyword routines, which all 
use FIND. WINDOW. 

The next step is to allocate memory 
for a stored image. MT.ALCHP attempts to 
reserve D1 bytes on the Common Heap. If 
this works, the space is prefixed with ‘Bufa’, 
so thatthe DIY Toolkit DISCARD command 
knows that it can safely be released. The 
space is also added to the list maintained 
by Toolkit 2, so it can be released with 
RECHP or CLCHP, and automatically freed 
after LOAD, LRUN or NEW. 


Linked list 


Toolkit 2 uses the first four bytes of 
each heap allocation made with ALCHP to 
link the allocations into a list. The un- 
documented system variable at 224(A6) in 
the SuperBasic area normally holds zero, 
but Toolkit 2 updates this to point to the link 
in the most recent ALCHP space. 

In turn, this link may contain the 
address of another link, at the start of 
another ALCHP space, or zero to signify 
the end of the list. CLCHP and the com- 
mands that remove the current program go 
through the list and deallocate each space. 
The listis ignored if you do not have Toolkit 
2 on your machine. The next eight bytes 
indicate the size of the stored image. First 
comes along word, the total size requested 
in bytes, followed by two words: the number 
of pixel lines in the window (less one to suit 
DBRA), and the compression indicator held 
in D6: All the remaining space is used to 
store window pixel information, read from 
the screen display. 


Shared code 


The subroutine labelled 
SCAN_LINESis central to all DIY Windows 
keywords. My original keyword routines 
each used a double loop to scan the win- 
dow and process each word of display 
memory. The outer loop stepped from line 
to line, while the inner loop processed the 
individual words of each line. This was 
rather a waste of memory, as the same 
instructions were used to step between 


> 
show-* 


Swap-* 


swap—* 


setred-* 


re eee ee ee 
STETEVETETTEE 


a 


2 


store-* 


crunch—+ 


a er ee) 
reves 


6 


5S new PROCedur es 


6, W_SHOW* 
6,7 W_SWOP? 
6,‘ W_SWAP 
7,’°SET_ RED’ 


setgreen—* 
9, SET_GREEN* 


End of PROCs 


2 new FuNctions 


7,’ W_STORE* 


8, *W_CRUNCH? 


End of FNs 


lines in every case. 

The improved version is almost as 
fast, yet 48 bytes shorter, because the 
shared subroutine SCAN_LINES is used 
tostep between lines. The action performed 
on each line is determined by the value in 
register A3 which points to a distinct sub- 
routine for each possibility. In every case 
D2 indicates the line width, and A4 points 
to the first word of each line. 

The line manipulation subroutines 
are collected at the end of the listing. For 
instance, SAVE_BYTES copies alternate 
bytes from display memory, at A4, to the 
buffer at AO. SAVE_BYTES is used by 
W_CRUNCH. SAVE_WORDS is the cor- 
responding loop used by W_STORE; it 
copies a word ata time. SWAP_WORDS is 
used by W_SWAP and W_SWOP,; it ex- 
changes odd and even bytes in display 
memory. 

All eight routines are called from 
SCAN_LINES, which sets D2 and Aé4 to 
process each line in turn. The code could 
be 28 bytes shorter if the DBRA D2 loops 
were moved to SCAN_LINES, but this 
would slow things down disproportionately 
because of the need to call a subroutine to 
process each word, rather than each line. 


Wide windows 


Minerva users with wide windows 
might speed up W_STORE and W_SHOW 
by calling the MM.MOVE vector, $158. The 
advantage is slight as they must call the 
vector for each line, unless the window is a 
full 512 pixels wide. The remainder of the 
code for W_STORE and W_CRUNCH 
shouldbe familiar. This ‘normalisation’ code 
is used by many QL extensions. It was 
discussed in my May 1988 QL World col- 
umn and CHANCODE_DOC in DIY Toolkit 
Volume C. It converts the address of the 
heap allocation in D1 into six-byte QL 
floating-point form, so it can be returned to 
Basic. 

You should now be sufficiently cog- 
nizant of the DIY Windows design to un- 
derstand the entire SWAP routine. Only 


ten lines of unique code are needed to 
implement W_SWAP and W_SWOP. The 
first five lines call GET_CHANNEL and 
FIND_ WINDOW to read and analyse the 
channel parameter. Then they point A3 at 
the SWAP_WORDS subroutine, before 
falling into the SCAN_LINES loop, which 
calls SWAP_WORDS for each line in turn. 

SET_RED and SET_GREEN work 
much the same way, but take an extra 
parameter which determines the routine 
called by SCAN_LINES. If this parameter 
is 0 or 1 the corresponding colour bytes 
must be set or cleared. In both cases the 
FILL_BYTES loop is used to copy the 
value of D6 into alternate bytes of the 
window. D6 is zero if the bytes are to be 
cleared, or -1 to set all bits. 

If the second parameter is -1 the 
RED_BYTES or GREEN_BYTES loop is 
selected, to copy information from one set 
of colour bytes to the other. Green bytes 
are stored before red ones, so SET_RED 
-1 goes faster than SET_GREEN 1, which 
must step backwards to copy each red byte 
toa green location, then step forward to the 
next word. 

The only unexplained keyword is 
now W_SHOW, which is encoded after the 
FIND_WINDOW subroutine. Unlike the 
others, this takes a long integer parameter 
after the channel number. This is the ad- 
dress of the window contents to be restored. 
SHOW starts by checking that there are 
two parameters, and hides the second one 
before calling GET_CHANNEL. There is 
no need to check the value of D3 after this 
call as A3.and A5 differ by 8, delimiting a 
single parameter. 

CA.GTLIN is used to fetch the long 
word address, which should be positive 
and even. The compression indicator is 
read into D6 before the call to 
FIND_WINDOW, so it gets the size right. 
W_SHOW reports ‘out of range’ if the size 
or depth of the window has changed since 
it was stored. Otherwise it uses 
LOAD_WORDS or LOAD_BYTES to re- 
store the image, depending on the value of 
D6. 
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Various modes 


DIY Windows commands are de- 
signed to suit Mode 4 displays, but they 
can also be used to save and restore Mode 
8 windows. There is a potential problem 
with SET_ GREEN and W_SWAP in Mode 
8, as these commands may set flash bits 
as well as green bits, leading to a chaotic 
flashing display. 

The problem occurs because Mode 
8 uses four bits to record the details of each 
pixel. Alternate bits in the even bytes turn 
flashing on and off. Corresponding bits in 
the odd bytes control the blue component 
of the colour, so the odd-numbered ink 
colour blue, magenta, cyan and white make 
the window flash after SET GREEN or 
W_SWAP. 

To correct this, alter the commands 
to check the display mode with a call to 
MT.DMODE (TRAP #1, DO=16); remember 
to preserve A4 as it is corrupted by the call. 
If Mode 8 is in use you must mask each 
byte stored at an even address with AND 

| #170 to ensure that the flash bits are not 
set. This enhancement requires two new 
line-scanning loops, based = on 

GREEN_BYTES and SWAP_WORDS. 


The existing code works perfectly in 
the Thor XVI's extra Mode 12, which re- 
places the flash bits with intensity controls, 
giving 16 colours on an RGBI TTL monitor. 
Italso copes with Minerva’s second screen, 
as it works out the window address from 
SD.SCRB in the channel definition. 


Extra screens 


In fact it is possible to have even 
more ‘logical screens’ in QL memory. 
Sinclair's display hardware can only read 
screens starting at 131072 or 163840, but 
Minerva lets you move the system vari- 
ables even higherin memory, leaving space 
for extra 32K screens. To display these you 
need to move their contents into one of the 
hardware display areas, with MM.MOVE 
or W_STORE and W_SHOW. 
> If you already read the screen froma 
remote machine using the MEM device 
and network file server, all you need to do 
is change the start address used by MEM. 
The Minerva rom can put text anywhere in 
memory, depending on the values in the 
channel definition. If you have a Gold Card, 
scrolling and output to screen addresses 
above 196607 should be extra-fast as there 
isno need to update slow eight bit memory. 


DIY TOOLKIT 


There are two ways to re-direct text 
and graphics to extra screens. You can 
update SD.SCRB to point to the start of the 
required screen, at any even address, or 
leave the default of 131072 and store atop 
line number greater than 255 in SD.YMIN. 

This value is multiplied by 128, using 
word arithmetic, and added to SD.SCRB to 
find the base address of the window. Thus 
it is possible to position a window that 
overlaps between two screens! | thank 
reader P H Tanner of Glasgow for this idea. 

Such POKEs require the use of 
CHBASE, from DIY Toolkit Volume Q, to 
find the channel definition from Basic. 
Machine coders can get the same effect 
with an SD.EXTOP call. 


Next issue 


DIY Toolkit will be back next month with 
a useful command that will help you generate 
neat formatted reports on the vocabulary of 
your SuperBasic interpreter, onallQL systems 
from AH to Minerva, occupying only 276 bytes 
of memory. . | am always on the lookout for 
new, useful and concise extensions to the 
Qdos system, and welcome suggestions from 
readers. Please write to DIY Toolkit, care of QL 
World. 


SUBSCRIBE TO 


SINCLAIR QL WORLD! 


SUBSCRIPTION FORM 


Rates (12 months) 
U.K. 

Europe: 

Rest of World 


£23.40 
£32.90 
£40.90 


Select back issues available on request. Please call for details. 


Cheques should be made payable to Arcwind Ltd. 
Please debit my credit card/Access/Visa 


Card No. 
Expiry Date 


Send the completed form to: 


Arcwind Ltd 
The Blue Barn, 
Tew Lane 
Wootton 
Woodstock 

Oxon OX7 1HA 
Tel: 0993 881181 
Fax: 0993 811481 


Please send me a 12 Month subscription to Sinclair QL World 


Name 
Address 


Telephone No. 


Signed 


Date 


Sinclair/QL World August 1992 


a7 


INFORMATION 

Program: Open World 2.0 
Supplier: Ergon Development, 
cfo Davide Santachiara, Via 
Emilio de Marchi n.2, 42100 


Reggio Emilia, Italy. 
Memory: 256K 

Price: £25 (disk) plus£5 carriage. 
All payable to D. Santachiara. 
Add £4 for sterling cheques; 
nothing for Eurocheques in Lire. 


he QL has various pro 

grams which can be used to 

design pictures both for use 
onthe computer screen and foruse in 
printed material. However, for the 
less artistic, itean be difficult to come 
up with ideas. Other computers have 
a wealth of public domain picture 
files which can be used, some of 
which are truly excellent pieces of 
computer generated art, These can be 
used ina display or even to inprove 
| the Jook of your documents. 

Although there are some public 

domain pictures for the QL, these 
tend to be. what is Known as ‘clip art 
(a sernes of small pictures stored on a 
larger sercen, which may then be cut 
out from that screen and used to 
embellish desktoppublishing). There 
havchowever been two new releases 
on the QL scene to give the user, 
greater access w pictures designed 
on other computers. One of these 1s 
CGH Service's STOQL, which al- 


lows you Lo access various Lypes of 


pictures created on an ST computer 
{a program which T wall not dwell 
upon because [am partly responsible 
for 1. Open Worle as the other. 

Open World comes supplied on 
a disk or microdrive together with 
a twelve page Ad manual. The 
manual is well written and casy to 
follow. On loading the program 
with the supphed boot program, 
you are presented with a start-up 
screen giving a little information 
about the program. Pressing any 
key will give you the main menu 
from where you can decide the 
type ol screen to be converted into 
QL tormat, 

Provided that you have already 
used a uliltty (such as Never) to 
convert a disk containing the 

| screens into QL formal, Open 
World can then be used to read the 
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disk and convert the following 
screen formals: 


IFF - Generated on an Amiga 
computer (for example using the 
program Deluxe Paint), 

GIF - A standardised screen 
format widely used on PC’s, 

TIF - Generated by different 
scanners and desktop publishing 
programs on PCs and MacIntosh 
computers, 

CUT - A less widely used for- 
mat but available on various com- 
pulers. 


Open World uses a system of 

Various Casy lo operate menus Lo 
choose the various funcuons and 
sel various parameters. The menus 
are based upon Ergon’s own 
standard menu system, which al- 
lows you to choose options either 
by moving a cursor bar onto the 
appropriate item, or by pressing a 
key associated with each option. 
Their operation is explained in the 
manual and, as with all of Ergon’s 
programs, Us makes the program 
easylogelusadto. 
Once you have chosen the type ol 
image to convert, a menu is dis- 
played containing a listof the files 
on the given Working Device 
which contain the appropriate 
suffix (eg _GIF for GIF files), 
You can then easily choose which 
file you wish lo convert, using the 
cursor bar. Ifyou are lucky enough 
to have the Files-2 system, you 
will be pleased to note that Open 
World supports full sub-directo- 
ries. 

If you have chosen to convert a 
GIF or [FF file, asmall window is 
opened 

onscreen which displays useful 
pieces of information about the 
file, which can be used to improve 
theimageilyouwssh. 


Having loaded the file to con- 
vert, you are given a further sub- 
menu which allows you Lo set the 
conversion parameters. Some 
converted screens may be larger 
than the QL screen, so to help 
with these, you are able to specify 
both x and y offsets for the top 
left hand corner of the screen 
being loaded. On top of this, you 
can also alter the size of the dis- 
play by altering the parameter 
‘Output ser_500x240a6x8" to the 
desired window size. Other pa- 
rameters allow you to specify 
whether the screen should be 
converted in mode4d or mode8, 
and how much memory should 
be allocated for the conversion 
of GIF files. 

Another option (called Dither- 
ing) allows you lo convert screens 
in monochrome mode. Open 
World uses quite a complex al- 
gorithm to ensure that the result- 
ant black and white image retains 
the original resolution and the 
grey scales introduced make a 
fair allempt al retaining the col- 
our diversity, This does however 
tend to degenerate mode’ pic- 
lures, although this will of course 
depend very much upon the 
original image. 

Having set the conversion val- 
ues, you can then choose to proc- 
ess the file. Open World will load 
the appropriale conversion routine 
from the Main Device prior to 
loading the file. The conversion 
process is generally quite quick, 
although the GIF conversion takes 
longer for various reasons ex- 
plained in the manual. Apparently, 
GIF files can be ‘interlaced’ and 
contain up wo 256 colours. As a 
result, the nnage must be loaded 
into Memory and then some cal- 
culations mustbe carried out upon 
the image belore it can actually be 
displayed on screen. 


Rich Mellor looks through a collection of pictures 
which can be easily converted for use by and ona QL. 


Although the QL cannot (cur- 
rently) display as many as 256 
colours (even the THOR XVI can 
only display a maximum of 16 
colours), the conversion programs 
each make a valiant attempt al 
ensuring that the picture retains 
most of its original resolution. 
However, with current levels of 
QL technology, you will nced to 
view the image on a black and 
white monitor to obtain the best 
results! 

Having converted the program 
youcan then save the image in QL 
format onto any device, thus al- 
lowing you to use these pictures in 
your own programs or displays. If 
however, you have several pictures 
lo convert, it may be useful to use 
the “Transfer to ram’ option (pro- 
vided that you have a ramdisk 
available). Lf you choose this op- 
tion, Open World will transfer all 
of its overlays onlo a ramdisk 
(ram1_) and from then on it will 
access the ramdisk for its own 
files, allowing you to use the 
program easily on a QL with only 
one disk drive. 

Overall the program is very 
slick, and enables you to convert 
the various form of images very 
quickly and easily. ] only found 
one or two minor errors in the 
program, all of which have been 
notified to Ergon and which | 
understand they will soon rem- 
edy. If you are in need of a few 
images to get you started, [ un- 
derstand that Ergon can also 
supply two disks (for £2 each) 
full of GIF and IFF screens. I 
have seen a few of these screens 
and can say that they would ap- 
pear to be of very good quality. 
Many users will undoubtedly find 
ause for such a program, particu- 
larly those with access to bulletin 
boards, which seem to contain an 
endless stream of such images. 
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INFORMATION 

Program: QMenu 

Supplier: Jochen Merz Software 

Im Stillen Winkel 12 

4100 Duisberg 

West Germany 

Price: £12.00 plus VAT, plus £4.50 carriage 
Updates cost £5 plus £4.50 carriage. 


menu is the documentation for an ex- 

Q tension Thing (special toolkit), menu 

rext’, which provides easy-to-use 

menus and a special scratch-pad area. 

Menu_rext defines two extension things, 
“Menus’and‘Scrap’. 

The advantage of writing a toolkit as an 
extension Thing is that it is not specific to 
SuperBasic, and may be used from other 
languages such as C or Forth. Most normal 
QL toolkits can only be used from SuperBasic. 
All the work required to handle Things in 
your QL is handled by the Thing System in 
the Qjump file ‘hot_rext’, which is bundled 
with Qpac land I, Qd3, DataDesign, etc. The 
Thing system is a (linked) list of named 
resources that may be used by QL programs 
in an ordered manner. 

Qmenu provides enough information to 
use the ‘Menus’ and ‘Scrap’ extensions with- 
out having to worry about how to use exten- 
sion Things. Things are given a technical 
explanation in chapter 17 of the Qdos Refer- 
ence Manual available from Jochen Merz. 
software for £30 excluding postage. 

Expanded QLs are beginning to see more 
and more extensions building upon other ex- 
tensions. First seen in Qram, PTR_GEN han- 
dles the pointer and added handling for extra 
graphic objects, while WMAN built upon 
PTR_GEN to provide an easy-to-use menu 
system. Programmers find WMAN hard to 
use from their programs, as they have to 
wrestle with Qptr, the documentation for 
PTR_GEN and WMAN. Hot_rext, introduced 
in Qpac |, contains the Thing system and the 
Hotkey System II. 


Co-operation 


‘Menus’ follows this theme of co-opera- 
tion, using WMAN and Hot_rext. The 
‘Menus’ extension uses the Thing system 
(hot_rext) to let the rest of the system know 
that it is ‘in the house’. All a program has to 
do is to ask the Thing system if it can use the 
Thing called ‘Menus’. To provide the easy- 
to-use, pointer-driven menus. the “Menus’ 
Thing uses the Window MANager, WMAN. 


TWARE FILE 
Omen 


Qmenu helps programmers use parts of the QJump 
Thing system without mastering the entire system 
Ian Bruntlett assesses it. 


A SuperBasic program demonstrating the uses of Qmenu 


100 REMark QmenuQLW2_bas (C) lan.R.Bruntlett April 1991, 1992 
110 REMark demo of new qmenu, SELECT_LIST 
120 REMark 5/5/92 modified for more useful file picking 
130 _Compiled%=1 
140 REMark $$asmb=flp1_Outin_rext,0,54 
150 REMark S$off 
160 Compiled%.=0 
170 REMark $$0n 
180 IF _Compiled% THEN OPEN #0;'con_512x256a0x0'-OUTLN #0;512,256,0,0 
190: 
200 REPeat Loop 
210 Option=SELECT_LIST(‘SLST demo’,’1. Stuff filename\2. Stuff file from devi3. Stuff device\4. Execute 
job\s. VIEW a file\6. Set PROGD$\7. Edit PROGDS\8. Set DATADS\9. Edit DATAD$\A. Edit stuffer’,,,10) 
220 SELect ON Option 
230 =0:PRINT #0;'ESCape!’:EXIT Loop 
240 =1: 
250 ~—sfile$=FILE_SELECTS$(‘Stuff filename’) 
260 IF file$<>"" THEN HOT_STUFF file$:EXIT Loop 
270 =2: 
280 _Hk$=FILE_SELECTS$(‘ilename to stuff’, OIR_SELECTS(‘directory for stuff’,,,,2),,,,,2):F Hk$<>" THEN 
HOT_STUFF _Hk$:EXIT Loop 
290 =3: 
300 _Hk$=DIR_SELECTS(‘directory to stuff',,,,.2):IF Hk$<>" THEN HOT_STUFF _Hk$:EXIT Loop 
310 =4: 
320 —file$=FILE_SELECT$('Execute job’,,PROGD$,’_exe') 
IF file$<>” THEN EXEC fileS 
=5; 
fileS=FILE_SELECT$(‘Pick a file to view’) 
IF fileS<>" THEN VIEW_FILE fileS 
=6: 
subd$=DIR_SELECTS(‘Set programme default’) 
IF subd$<>" THEN PROG_USE subd$ 
=f! 
newPROGD$=READ_STRING§('Edit programme default’, PROGD$) 
IF newPROGD$<>”" THEN PROG_USE newPROGD$ 
=8: 
subd$=DIR_SELECTS$(‘Set data default’) 
IF subd$<>" THEN DATA USE subd$ 
ah 
newDATAD$=READ_STRINGS(‘Edit data default’ DATADS) 
IF newDATAD$<>" THEN DATA_USE newDATAD$ 
=10:;newSTUFF$=READ_STRINGS(‘Edit stuffer buffer ,HOT_NAMES(‘)) 
IF newSTUFF$<>” THEN HOT_STUFF newSTUFF$ 
510 END SELect 
520 END REPeat Loop 
530 STOP 


To keep things simple I willcallamenu from — o¢Qpac I. This is nottoo surprising, as *Menus’ 


Qmenu a Qmenu, and any other menu a menu. 
When I give a Qmenu’s SuperBasic name I'll 
put its four character “extension thing’ name in 
square brackets after it. 

First of all, are the Qmenus practical? Yes. 
When a user is confronted with a Qmenu, it is 
no different to being given a menu from Qram 


uses WMAN (which is also used by Qram and 
Qpac 11). It does show that Jochen Merz has 
observed the few guidelines in Qptr which are 
along the lines ‘CTRL F2 causes the informa- 
tion displayed to be refreshed, ESCape removes 
a window without performing any (further) 
action, etc.”. So there are no nasty surprises for 


Sinclair/QL World August 1892 


SOFTWARE FILE 


the user. 

‘Menus’ is a set of nine specialised menus 
biased towards file handling. The colours of the 
menus can be defined by setting *colourways’, 
which are a number from 0-4, the default being 
‘white/green’. As the menus rely on the window 
manager, the programmer must ensure that the 
job the Qmenu is being used in has a “managed 
window’ (set by iop.outl, trap #3, d0=$7a). 
SuperBasic programrs are provided with 
OUTLN, an extra toolkit command which does 
this. 

The most impressive of the Qmenus is 
FILE_SELECT$ [FSEL]. This brings upa large 
menu which has two large areas, one to show 
subdirectories (but only on the Miracle hard 
disk and other level-2 device drivers), and the 
other to show a list of filenames, Itis very casy 
for the user to change device - a list of the 
directory devices present in the QL ts part of the 
menu, choosing one of them causes FSEL to 
display a list of filenames from the new device. 
There ts a slight problem with the listof devices 
- if there are two devices that begin with the 
same letter then only the first of those devices 
can be chosen with a single key press. This is 
only a minor problem, as keyboard users can 
still move the pointer to the desired device 
name and hit’ it. 


Hitting 


‘Hitting’ the sub-directories entry pulls down 
a further qmenu - DIR_SELECT$ [DSEL|]. 
This qmenuallows you to choose a device from 
‘mdv1/2, flp1/2, ram 1/2, winl/2’, or any of the 
eight user defined sub-directories that may be 
set with Qjump's Config. This shows a weak- 
ness of Config - there is no ‘update’ function: 
if you configure a piece of software and later on 
receive an updated version, all you can do is to 


Est 


Fi leranes 


Directorys 
FLP2_ 
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overwrite the old version and configure the 
new version. It would be much more conven- 
ient if | could just tell Config: “Here 1s the old 
configured version, use my configuration 
choices from the old version as the default 
choices for the new version’. 

‘Hitting’ the file extension entry pulls down 
another qmenu-EXT_SELECT$[XSEL]. This 
isa list of ten common file extensions. They are 
common to programmers 
‘bas\pas\asm\txticlerr\lis\t87\map\exp’. The 
default extensions may be configured by the 
user to suit. 

The FILE_SELECT menu has one more 
trick up its sleeve - it can read the stuffer bufter 
(ALT-Space) so the filename return could also 
be the current or the previous contents of the 
stuffer buffer. 

There is one refinement I'd like to see in 
FILE_SELECT. | would like it to be able to 
show a file (for example, with the Qmenu 
VIEW_FILE) so that the user can make sure a 
certain file is the correct file before clicking 
‘Ok’. 

FILE_ERROR will either return -! if the 
error to be dealt with is not a file error, or it will 
produce arelevant menu with options for retry/ 
abandon/overwrite, etc, returning a unique value 
for each user choice. This is a new addition to 
Qmenu. 

VIEW_FILE [VIEW] is a relatively simple 
file viewer. It shows a file in a big window and 
allows youto set WRAP ON (lines are wrapped 
around at the end of the window, like COPY 
file TO SCR) or to set WRAP OFF (lines too 
long to fit in the window are truncated, like 
VIEW file). Itis similar to the Qpac? file viewer 
- pressing Space reads a further line, Enter reads a 
whole page and CTRL-F2 (Wake) causes the 
beginning of the [le to be displayed again. The only 
missing facility is a scroll barto move quickly from 
one part of the file to another. 


Load text file 
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Config 


New versions of Qjump’s Config now use 
the FILE SELECT menu if itis present. Now 
you have the strange situation of being able to 
run Config, which in turn will use menu_rext to 
get a filename from the FILE_SELECT menu, 
which in turn gets configured by Config! This 
kind of co-operation should be more frequent. 

The other qmenus are less file-oriented: 


READ_ STRINGS [RSTR] brings up asmall 
window with a title and prompt and allows the 
user to edit some text (possibly a file name). 

REPORT_ERROR [RPER] brings upasmall 
window with a standard Qdos error report in it 
and waits for the users to acknowledge its 
existence - then it removes itself, 

ITEM_SELECT [ITSL] brings up a small 
window with a title, prompt and up to three 
options to be chosen. Despite having three 
options, this menu can still be used to display a 
Toolkit 2 look-alike ‘yes/no/all/quit” promptas 
it returns | to 3 for a selected option and 0 for 
ESCape. The options may be chosen by press- 
ing the first letter of the option name or by 
clicking an option with a mouse. 

Choice%=item_select((QLW Test 
menu’, You have no option but to choose 
one’, No’ AIP,’ Yes’) 


During the passage from Qmenu versiontwo 
to version three, Qmenu has diversified into list 
handling. There are three list handling routines 
- SELECT_LIST, SELECT_LISTS and 
LIST_SELECT. Only LIST_SELECT is meant 
to be used these days - the SELECT_LIST 
routines are only included for compatibility. 

The LIST_SELECT routine will bring down 


Pre. tows 


E ped 
Lchend red 
B MARS medness med 
) MARS nice red 
2 MARS mil red 
MARS _poras | beg_red 
» MARS _ piper ped 
# NARS p loaque_red 
@ MARS = temper red 
MARS _¢torm red 
MARS 2 ped 


ee a | 


ry 


SOFTWARE FILE 


a menu of items, but has two modes of op- 
eration. It can be used as an option list 
where the user can switch options on/off, 
returning when the user has finished set- 
ting the options, Or it can act as a con- 
ventional menu, returning when the user 
has selected a single option. 

The other extension Thing, “Scrap Ex- 
tensions’, handles the ‘Scrap’. The ‘Scrap’ 
is an areca of memory which can be used 
for memory-based importing/exporting 
between programs. The programs have to 
specifically access the scrap, so it won't 
be used by the Psion programs. 

There are SuperBasic commands and 
machine code routines to clear the scrap, 
put information in it, find out what kind 
of information is in the scrap and to read 
the scrap. 


Documentation 


So now you have 
been introduced to 
*“Menus’, what about 
the documentation 
and facilities for pro- 
grammers? [n no way 
do the above descrip- 
tions render the 
‘QOmenus” documen- 
tation redundant. The 
manual seems to have 
been written in the 
“Optr’ style of manual 
writing. that is, con- 
cise and to the point. 
Occasionally it is loo 
concise - the assem- 
bly language pro- 
grammer would feel a 
bitlet down if all there 
was to go on was the 
manual. Fortunately, 
there is a full demo in 
assembler on the disk, 
and the source files 
are provided, 

To access the 
‘Menus’ from assem- 
bler, Jochen Merz 
provides some as- 
sembly language 
source code files. 
Previous versions of 
Qmenu provided S- 
ROFF (Sinclair 
Relocatable Object 
File Format) files that 
needed a compatible 
assembler. Now that 
the source code for the 
access routines 1s 
provided, you can use 
Qmenu with any QL 
assembler. 

If you are unfamil- 
iar with the *Thing” 
system, you should 
read the Qjump docu- 
ment ‘thing ext’ on 


the Quanta SPECIALS. 0 disk before us- 
ing Qmenu. You may find my 
*Qdos_Listthg_bas’ on the CGH Services 
MISC PD disk a handy way of finding 
information on Things, 

Despite those reservations, Qmenu is 
definitely usable by assembly language 
programmers. Each menu is defined rea- 
sonably well, although the manual occa- 
sionally returns to being too concise. For 
instance, the FILE_SELECT menu can 
modify the directory string or extension 
string passed to it. This is explained away 
with “If the update bit in the directory or 
extension parameter is set, then, if the 
user changes the extension or the direc- 
tory, the string is updated (if it is not a 
key)". Which update bit? Could it be in 
the definition of the Thing parameters in 
*Menus’ or does it refer to the parameter 
block that we pass to the qmenu code 
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itself? 

The SuperBasic programmer fares bet- 
ter than the assembly language program- 
mer as far as documentation goes. Each 
SuperBasic extension is listed and de- 
fined. At the moment the ‘SuperBasic- 
Thing’ interface cannot handle multiple 
return parameters, so one or two facilities 
are unavailable from SuperBasic. It even 
mentions some facilitics that are due to 
be implemented. 


Serious 


If you are a programmer who is going to 
make serious use of qmenus within your 
own programs, buy Qmenu. You are go- 
ing to need it. A dabbler could get by on 
guesswork without Qmenu, but would end 
up not using the full facilities of the 
‘Menus’ extensions. 

The ‘Menus’ exten- 
sions are very useful 
and casy to use in a 
program, If you have a 
small program which 
would be very useful 
but the user interface 
work via Qptr would 
be too much effort, use 
the Qmenus., You 
won't have the degree 
of control that Qptr 
gives you, but the re- 
sult will be a saving in 
time. All that is miss- 
ing now from Qmenu 
is a ‘main window’ 
menu which has indi- 
vidual “Qmenus’ built 
into it, placed by the 
programmer, waiting 
to be invoked. 

I have two simple 
SuperBasic programs 
which have been made 
easier to write and 
better to use by 
Qmenu. One, ‘yvdat’, is 
a filter that uses 
SELECT_LIST when 
deciding which Psion 
printer driver to list. 
The other, a test bed 
for this article, is ona 
hotkey to set Toolkit 2 
defaults from the 
DIR_SELECTS, stutf 
a, filename from 
FILE SELECTS, ete. 
Both were simple pro- 
grams made more 
useful by Qmenu. 

People who are go- 
ing to use the "Menus’ 
extensions only in 
packages that use it 
(such as Easy Pointer 
or Qd2/3) will not gain 
anything by buying 
Qmenu. 
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In part 9 of this series 
for new programmers, 
Alan Bridewell puts his 
routines to the use of 
saving and re-loading 
screen files. 


ny program which is con 

cerned with screen graphics 

will usually require the ability 

to save screens to files, and 

also reload such screen 
filesback to the screen. In this section, 
we shall look at routines for doing just 
that. Most of the coding here has been 
dealt with before as smaller chunks, 
so if you have been following the se- 
ries, you should not have much diffi- 
culty with it. However, as they occur 
so often in applications, it seems rea- 
sonable to include them in the series 
in their own right, rather than leave 
you to construct them from smaller 
chunks. 

Listing one gives the 
Screensave routine. Although it is not 
complicated, it does present a par- 
ticular problem which needs to be 
overcome one way or another. The 
problem is this: in order to save the 
screen toa file, we need to open anew 
file on disk or microdrive. To do this, 
we need to first prompt for a file name, 
which must then be typed in. This, of 
course, means using the screen, which 
is also to be used for the display to be 
saved on the file. One solution would 
be to use a window in part of the 
screen not required for the display, 
which is fine so long as the display 
does not require the entire screen. 

| prefer a slightly different so- 
‘ution. | open a suitable file before 
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stematic 


Machine Code , 


Programming 


Listing i 


FEES TEETER FE TE EIT ITE IETF TEE IE HEI IEE 
$ ‘SCREENSAVE ' 
Ne tL tt fee. herr et es 
5 THIS ROUTINE WILL PROMPT FOR THE NAME OF A NEW FILE, AND SAVE THE @L’‘S 
SCREEN RAM IN THE FILE 


PUT PROMPT ONTO SCREEN 


«MESS MOVE.L OR 4(A7),AO GR B(A7),AO, ETC. 


(A7) , AG : 
; CHANNEL ID IN AO 
F 
5 


LEA.L MESSAGE , AL BASE ADDRESS IN Al 
MOVE. W $DO ,AZ ; UT_MTEXT VECTOR IN A2 
JBR (A2) 
BRA.§& INSTRING 5 SKIP MESSAGE 

» MESSAGE DC.W a4 5 LENGTH OF MESSAGE 
DC.B ‘Name of new screen file’ 
DC. 10 ; CRLF 
DC.B "(including device): 


GET STRING FROM KEYBOARD 


’ 
. INSTR MOVEQ #BUF_LEN,D2 5; LENGTH OF BUFFER IN D2 
MOVE.W #SFFFF,DS 3 INFINITE TIMEOUT 
LEA.L BUFFER,Ai ; BASE ADDRESS OF BUFFER IN Al 
MOVEQ #2,D0 3 #10 _FLINE IN DO 
TRAP #3 
LEA.L BUF_POS,A0 3; BUF_POS IN AO 
SUBE.L #1,D1 3 SUBTRACT 1 FROM THE Dil REMOVES 
5 THE &F FROM THE STRING COUNT. 
MOVE .W Di, (AG) 5 PUT NEW STRING LENGTH IN BUF_POS 


TRY TO OPEN & CHANNEL TO THE FILE 


wouwswe 


LEA.L BUF_POS,AG ; BUF_POS IN AQ 

MOVE #2,D3 3 OPEN NEW EXCLUSIVE FILE 

MOVER #-1,D1 ; JOB ID FOR THIS JOB 

MOVEQ #1,D0 3 #10_OPEN IN DO 

TRAP #2 

TST.L DO 3 ERROR? 

BEO.S CONT 3 «IF NOT, THEN CONTINUE. ELSE:— 


THEN THIS IS USED 
BRA MESS 3; GO BACK TO PROMPT 
ALTERNATIVELY, YOU COULD BRANCH TO CODE TO KILL THE JOB 


IF ERROR, 


IF NO ERROR, THEN THIS CODE IS USED. 
¢ OR YOU COULD JSR FO A ROUTINE TO GENERATE GRAPHICS, 
3 AND RTS TO .TRA ) 


‘ae ee ee ae 


«CONT MOVE. L AO ,—(A7) 5 SAVE FILE CHANNEL ID 

»MESS2 MOVE. L 4(A7) AO 5 CHANNEL ID IN AO 
LEA.L MESSAGE2,A1 ; BASE ADDRESS IN Al 
MOVE .W #D0,A2 3 UT_MTEXT VECTOR IN A2 
JSR (AZ) 
BRA.S PRIORITY 3 SKIP MESSAGE , 

.» MESSAGE2 DcC.W 29 3 LENGTH OF MESSAGE 
DC.B ‘NOW CREATE SCREEN TO BE SAVED’ 
DC.B 10 3 CR,LF 


; REDUCE THE PRIORITY TO 1 


«PRIORITY MOVER #45 ,DO ; #MT_PRIOR IN DO 
MOVED #-1,D1 ; OF THIS JOB 
MOVE® #1,D2 ; TO. 
TRAP Ht ws 


3 
3 MONITOR THE KEYBOARD FOR <CTRL><SHIFT>X 


KEYROW LEA.L KEYR , Az 3 KEYROW PARAM TABLE IN 43 
MOVEQ #411,D0 5 #IPCOM IN Do 
TRAP #1 
CMPI.B #11,D1 3 IS <CTRL><SHIFT>X PRESSED? 
BEQ.S PRIOR2 5 IF PRESSED, MOVE ON 
BRA.S KEYROW 3 IF NOT, TEST AGAIN 


setting up the screen to be saved. 
Then when the screen is ready, press- 
ing the appropriate key combination 
will] save the screen to the file. 


Two ways round 


This method lends itself to two 
alternatives. If the same program is 
going both to generate and to save the 
display, it must branch off to the rou- 
tines which generate the display after 
the file has been opened, and then 
return to the routine when the display 
is ready to be saved. On the other 
hand, the screen-saving routine can 
be in a separate, multitasking pro- 
gram. In this case, once the file is 
open, the routine can reduce its priority 
to 1 so that it does not slow down the 
screen generating program, and sim- 
ply wait in the background monitoring 
the keyboard for the right combination 
of keys. 

At this point, the user can Ctrl- 
C from the saving program into the 
generating program. When the appro- 
priate key combination is pressed, the 
saving routine will increase its priority 
to 32 again, and save the screen. 

Since a lot of the routine is 
given over to this approach, it is the 
default setting. The alternative is there 
as a one line BRA statement. 

The routine starts by putting a 
prompt into a suitable screen channel 
which was previously opened. It then 
takes a string from the keyboard as a 
channel name, and tries to use it to 
open anew, exclusive channel. If itis 
unsuccessful, it loops back to repeat 
the prompt. If the channel is success- 
fully opened, its channel ID is saved 
on the stack, and a prompt is put on 
the screen to carry on and generate 
the screen which is to be saved. 

After this, the routine reduces 
the priority to one, and then goes into 
a loop waiting for a particular combi- 
nation of keys to be pressed. The de- 
fault setting is to test for Ctrl-shift-X, 
because the three keys are in the same 
keyrow, and it is an unusual key com- 
bination. Clearly, you can alter this to 
suit your own requirements, Once that 
key combination has been pressed, 
the priority is raised again to 32, and 
the transfer of bytes from screen ram 
to file goes ahead. Finally, the file has 
to be closed. 


Taking it apart 


If you are interested in taking 
this apart, you will see that itis almost 
entirely constructed of smaller chunks 
from earlier parts in this series. They 
are, in order Message, Instring, Open, 
Message, Priority, Keyrow, Priority, 
Close. The only new bit comes just 
before the final Close. This is where 


MACHINE CODE 


3 

3 KEYROW PARAMETER TABLE 

«~KEYR DeC.B 4 
DC.B a 


; READ KEYROW 
; ONE PARAMETER 
DE.L ° } LOWEST FOUR BITS ONLY 
} ALTER NEXT PARAMETER TO REQUIRED KEYROW 
DC.5 7 ; 
; 


DC.B Zz 


TEST ROW 7 
REPLY OF & BITS IN D1 


3 

3 INCREASE FRIORITY BACK TO 32 

-PRIOR2 MOVED #$B,D0 #MT_PRIOR IN DO 
MOVED #-1,D1 OF THIS JOB 
MOVED #32,D2 TOL 
TRAP #1 


i 
3} TRANSFER BYTES FROM SCREEN TO FILE 
- TRA MOVE .L (A7) ,AQ 3 FELE CHANNEL ID IN AD 
MOVE.L #$20000,A1l 5 START ADDRESS OF SCREEN 
MOVE. W #SFFFF,DS 3; INFINITE TIMEOUT 
MOVE.L ##8000,D2 ; SCREEN SIZE IN D2 
MOVES #649 ,D0 5 FS.SAVE IN DO 
TRAP #S 
MOVES #2,D0 ; #I0_CLOSE IN DO 
TRAP #2 
5 FEES EE ER FE IEEE FEE EEE EEE EEE SEE EE EE ETE FEE FEE SE JE EE EEE FEE JETER FEE IEE IEE IEICE 
H TO BE POSITIONED AFTER THE CODE 
3 WE NEED ‘BUFFER’ FOR THE STRING AND ‘'BUF_POS’ FOR THE STRING COUNT 


5 
.« BUF_LEN 3 LENGTH OF INPUT BUFFER 
‘ 


5 

» BUF_POS 5 

: 

.» BUFFER 5 
eee NOTE **##*# BUFFER SHOULD COME LAST OF ALL. 


5 JERE FE EE EEE EE EE IE EE IE SEE SE ISTE EEF IESE JERE EEE EGE JEL HE IIE JETER TEETER 
Listing 2 


SEE TEE EE TET TE IEEE ETE ERIE TE IEEE TEI EJ TEE FETE TEETER IHEITETE IERIE IEE 
“SCREENLOAD* 

FEET IEEE HET FEE FTE FETE ETE TEE IEE TIE FE JO IEEE 

THIS ROUTINE WILL PROMPT FOR THE NAME OF A SAVED SCREEN, AND LOAD THE 

NAMED FILE INTO THE @L‘S SCREEN RAM 


PUT PROMPT ONTO SCREEN 
«MESS MOVE .L (A7) ,AO 3 OR 4(A7)},A0 OR G(A7),A0 ETC. 
3} CHANNEL ID IN AO 
LEA.L MESSAGE ,A1 3 
MOVE .W #D0,A2 i 
JSR (A2> 
BRA.S INSTRING 3 SKIP MESSAGE 
. MESSAGE Dc.wW 46 5 LENGTH OF MESSAGE 
DC.B ‘Name of saved screen file’ 
DC.B 190 3 CR,LF 
DC.B “Cinecluding device): 


BASE ADDRESS IN Ai 
UT_MTEXT VECTOR IN AZ 


3 GET STRING FROM KEYBOARD 
- INSTR MOVEO #BUF_LEN,D2 ; LENGTH OF BUFFER IN D2 

MOVE .W ®SFFFF LDS 5 INFINITE TIMEOUT 

LEA.L BUFFER,A1 3; BASE ADDRESS OF BUFFER IN AL 

MOVES #2,D0 3 #IDO_FLINE IN DO 

TRAP #3 

LEA.L BUF_POS,AO ; BUF_POS IN AQ 

SUBQ.L #1,D1 3} SUBTRACT 1 FROM THE D1 REMDVES 

5 THE LF FROM THE STRING COUNT. 

MOVE. W Di, (AO) PUT NEW STRING LENGTH IN BUF_POS 


3 
TRY TO OPEN A CHANNEL TO THE FILE 
LEA.L BUF_POS,AO ; BUF_POS IN AO 
MOVED #1,D3 OPEN OLD SHARED FILE 
MOVED #-1,D1i JOB 1D FOR THIS JOB 
MOVE® #1,D0 #I0_OPEN IN DO 
TRAP #2 
TST.L DO ; ERROR? 
BEQ.S GOT_FILE 5 IF NOT, THEN CONTINUE. ELSE:—- 


IF ERROR, THEN THIS IS USED ¢ OR BRANCH TO CODE TO KILL JOB?) 
BRA MESS 5 GO BACK TO PROMPT 


5 
; IF NO ERROR, THEN TRANSFER BYTES FROM FILE TO SCREEN , 
.»GOT_FILE MOVE.L #$20000,A1l 4 START ADDRESS OF SCREEN 
MOVE .W #$FFFF LDS 3 INFINITE TIMEOUT 
MOVE .L #%8000,D2 ; SCREEN SIZE IN D2 
MOVEQ #$45 ,DO 3 FS.LOAD IN DO 
TRAP #3 
MOVEQ #2,D0 3 #IO_CLOSE IN DO 
TRAP #2 
FIT TIE ITI R ITI IE E TT I TIE TIE 
TO BE POSITIONED AFTER THE CODE 
WE NEED ‘BUFFER’ FOR THE STRING AND ‘BUF_POS* FOR THE STRING COUNT 


BUF_LEN ; LENGTH OF INPUT BUFFER 
' 
. BUF_POS 3 


i 
- BUFFER | 


Sinclair/QL World August 1992 


the bytes are transferred from screen 
ram to file, using the trap 3 call 
FS.SAVE, which has #$49 in register 
DO. This also requires the start address 
to be saved 

in register A1, the number of bytes to 
be saved in D2, with an infinite timeout 
in D3. This code can be used to save 
any chunk of ram to a file, and works 
like the SBYTES command in Basic. 

Listing two gives the corre- 
sponding Screenload routine. Most of 
itis very similar to Screensave, except 
that as it does not have to wait for a 
screen to be generated, there is no 
need to have the second Message, or 
the Priority and Keyrow chunks in- 
cluded. Obviously, it will need a slightly 
different prompt on the screen, and it 
will open an old, shared file, not anew 
exclusive one. And, of course, it will 
transfer bytes from file to screen ram, 
and not the other way round. To do 
this it uses the trap 3 call FS.LOAD, 
which is identical to FS.SAVE, except 
that it has #$48 in register DO. 

This works like the LBYTES 
command from Basic. We can illus- 
trate the use of these routines with a 
program which will sleep in the back- 
ground, waiting to be called to either 
save ascreen to file, or to load a file to 
screen. It will then wake up and send 
suitable prompts to the screen, after 
which it will carry out the appropriate 
save or load. When this is completed, 
it will go back to sleep, waiting for the 
next call. 

The program starts in the 
usual way with Jobstart, and at once it 
opens a suitable console window for 
the prompts and file names using 
Console. It then uses Priority to drop 
its priority to 1 while it waits to be 
called. At this stage, the program is 
looking for three possible key presses, 
Ctrl-S for save, Ctrl-L for load, or Ctrl- 
Q for quit. 


Different Keyrows 


Since Ctrl-S, L, and Q are all 
in different keyrows, it needs to use 
Keyrow four times. The first Keyrow is 
to detect the Ctrl key and ignore all 
others. When a Ctrl is detected, the 
other three Keyrows are used to see if 
S, Lor Qis pressed at the same time. 
If none of these is pressed, it loops 
back to test for Ctr! again. If Ctrl-Q is 
detected, the console channel is 
closed and the job killed. 

On detecting Ctrl-S, the pro- 
gram jumps to Priority to bring the 
priority back to 32 so it can work, and 
goes on to Screensave. On complet- 
ing the Screensave routine, the pro- 
gram has to loop back to the first Pri- 
ority, so it can go back to sleep and 
wait for another call. So the single line 
BRA Priority is added to the end of 
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3 
3 *#e* NOTE *##*#*% BUFFER SHOULD COME LAST OF ALL. 
5 
: 


EE REE EEE EE EE EEE REE ETE EEE EEK ICE EE EEE EE REE 


Listing 3 


FIER EEE ERE EEE REET EEE HEE IEE IEEE TEI TE TE TEE EEE RE THEE EEE He 
3 *JOBSTART" 
3 


BRA.S START 5 BRANCH TO START OF CODE 
DE. i] 3 {THIS 18 STANDARD FORMAT FOR 
DC.W #4AFB 5 START OF A JOR) 
3 ---+ ALTER CHARACTER COUNT AND JOB NAME 
DC.wW 8 3 CHARACTER COUNT OF JOB NAME 
DC.B “SAVELOAD * ; NAME OF JOB 


3 

BEET IEE TE IE He ETE TE HEHE EEE HEHE EE IE IE FEE EE HE ETE TE FETE HE EEE ETE TE IEE JE HE ETE TEE EEE HE EE 

3 “CONSOLE ° 

3 OPEN THE CONSOLE CHANNEL 

} --~-- ALTER LABEL TO .START ---- 

« START LEA.L PBLOCK,At } PBLOCK ADDRESS IN Al 
MOVE. W $06, AZ ; UT_CON VECTOR IN A2 
JSR (a2) ; 


5 
3 SAVE THE CHANNEL ID WHICH UT_CON ROUTINE LEAVES IN AO. 
5 

MOVE.L A0,-—(A7) 3; SAVE CONSOLE 1D ON STACK 
3 
5 


CLEAR THE WINDOW 
3 


MOVE. W #SFFFF ,DS 
MOVEQ #$20,D0 
TRAP #3 

BRA.S PRIORITY 


INFINITE TIMEQUT 
#SD_CLEAR IN DO 


SKIP BLOCK 


DEFINITION BLOCK. 
-we- ALTER WIDTH TO 512 ---- 

PBLOCK Dc.B GREEN BORDER 
DC.B 2 PIXELS WIDE 
bC.B BLACK PAPER/STRIP 
DC.B WHITE INK 
DC.W WIDTH 
DC.W HEIGHT 
DC.W 5 X POSITION 
DC.W 5 Y POSITION 

i 

5 EERIE TEE IIE TE IRIE EGE IEE IGE KUEN at 

H “PRIORITY ’ 


3 

» PRIORITY MDVEQ #2B,DO 5 #MT_PRIOR IN DO 
MOVEQ #-1,Di 5 OF THIS JOB 
MOVEQ #1,D2 7 TO 1 
TRAP #1 H 


3 
5 EEE TEE EE EEE ETE IEE TE TE TETE HE FE ETE TE ETE TE HEHE HE IE SE IE FETE HE TE SEI FE HE EE EEE EEE Eee 
3 *KEYROW‘ 
3 
} — ALTER LABEL TO KEYROW1 AND LOAD ADDRESS TO KEYR1 -—-—— 
.KEYROW1 LEA.L KEYR1,A3 5 KEYROW PARAM TABLE IN 43 
MOVEQ #$11,DO | ¢ #IPCOM IN DO 
TRAP #1 
CMPI.B #2,D1 3 18 <CTRL> PRESSED? 
3 --~- ALTER BRANCH ADDRESS IN NEXT TWO LINES ---- 
BEQ.S KEYROW2 ; IF PRESSED, MOVE ON 
BRA.S KEYROWL 3; IF NOT, TEST AGAIN 
3 KEYROW PARAMETER TABLE 
} ---- ALTER LABEL TO .KEYRI ---- 
»KEYR1 9 ; READ KEYROW 


1 3 ONE PARAMETER 
pc ° ; LOWEST FOUR BITS ONLY 
5 ———— ALTER NEXT PARAMETER TO 7 —---— 
DC.B Zz 5 TEST ROW 7 
DC.B 2 5 REPLY OF 8 BITS IN Di 


HHT ET EEE ETE TEI TTF ETE FETE TE IEE FETE TER FETT TEER EE EEE HEE IEEE HEE 
“KEYROW' 


---- ALTER LABEL TO .KEYROW2 AND LOAD ADDRESS TO KEYR2 —---— 
»KEYROW2 LEA.L KEYR2,AS 3 KEYROW PARAM TABLE IN AS 
MOVEQ #$11,D0 3 #IPCOM IN DO 
TRAP #1 
CMP1.B #8 ,D1i 3; IS S PRESSED? 
3 —--- ALTER BRANCH ADDRESS IN NEXT TWO LINES —---— 
BED SSAVE 3 IF PRESSED, SSAVE 
BRA.S KEYROWS 5 IF NOT, TEST AGAIN 
5 KEYROW PARAMETER TABLE 
| -=<~ ALTER LABEL. TO .KEYR2 ——= 
«KEYR2 DC.B ? 3 READ KEYROW 
DC.B 1 3 ONE PARAMETER 
DC.L O 3 LOWEST FOUR BITS DNLY 
3-777 ALTER NEXT PARAMETER TO 3 ---— 
DC.B 5 3 TEST ROW 3 
DC.B 2 ; REPLY OF 8 BITS IN Bi 


; 
fb SEHR EERE EEE AE ERE E EERE EE EE EEERHEE EE RERE RRR REE REE EE ER EERE REE 


Screensave. In a similar way, if the 
program detects Ctrl-L, it jumps to 
Priority to bring the priority back to 32 
and then goes on to the Screenload 
routine. As with Screensave, the 
Screenload routine needs a BRA Pri- 
ority line added to the end so that it 
can loop back to wait for another call. 
The program ends in the nor- 
mal way with Close to close the con- 
sole channel, and Endjob to kill the 
job. So, putting all that together as list 
rather than a flowchart, we get: 


Jobstart, Console, Priority, Keyrow, 
Keyrow, Keyrow, Keyrow, Priority, 
Screensave, Priority, Screenload, 
Close, Endjob. 


Listing three shows all the chunks 
merged together to make the program. 
As before, many of the comments have 
been removed, and extra ones added 
to show exactly what alterations are 
necessary to make the chunks fit to- 
gether. You could, of course, simply 
type in listing three and assemble the 
program, but this would defeat the 
point of the exercise. It will be much 
more informative to merge the indi- 
vidual chunks into one file, and then 
make all the necessary alterations. 


Tailoring 


Having got the program to 
work, the next job is to improve it and 
tailor it to your particular needs. Doing 
this will really show you that you un- 
derstand the programming. 

One obvious improvement 
might be to add some sound, by get- 
ting the program to make a pleasant 
little sound when it has completed a 
save or load successfully, and a less 
pleasant one when it fails to open a 
file for saving or 
loading. If you have been following 
this series, you should have the 
SOUND routine all ready to merge into 
the program. 

When the program starts, it 
produces a blank console window, 
even though you are not ready to use 
it. This is nota major problem, but may 
be a bit annoying. Not only that, but 
the console window stays open the 
whole time, whether it is in use or not. 
It would be tidier for the window to be 
opened when it is needed for a load or 
save, and then closed again after- 
wards. This would make the program 
a bit longer, but would not be difficult 
to produce. However, if you did this, 
you would need to be given some sign 
that the program had loaded properly, 
so make it give another little sound 
just before it goes to sleep, just to tell 
you all is well. 

You can, of course, play 
around with the console window itself 


MACHINE CODE 


"KEYROW~ 


---— ALTER LABEL TO -KEYROWS AND LOAD ADDRESS TO KEYRS -—-— 
- KEYROWS LEA.L KEYR3,A3 5; KEYROW PARAM TABLE IN AS 
MOVEG #$11,D0 ; #IPCGM IN DO 
TRAP HL 
CMPI.B #1,D1 ; IS L PRESSED? 
3.0 ~7-- ALTER BRANCH ADDRESS IN NEXT TWO LINES ~—-- 
BE® SLOAD 3; IF PRESSED, SLOAD 
BRA. S KEYROW4 3 IF NOT, TEST AGAIN 
3 KEYROW PARAMETER TABLE 
3 ——7 ALTER LABEL TO .KEYR3 ---~ 
«»KEYRS DC.B F 
DC.B 1 
Dc.L a 
5 —--- ALTER NEXT PARAMETER TO 4 -—--- 
DC.B 4 ; TEST ROW 4 
DC.B 2 ; REPLY OFS BITS IN D1 


READ KEYROW 
ONE PARAMETER 
5 LOWEST FOUR BITS ONLY 


3 
PER IERIE FETE IE IE TE AEE HEHE IE FE TE TEE HE IEE IEE HE FE IE TE SEE TEE EFI ITE TEE EEE EIT ERIE IIE ee 
3 "KEYROW:? 
3 “ 
3 --—- ALTER LABEL TO .KEYROW4 AND BRANCH ADDRESS TO KEYR4a ———— 
» KEYROW4 LEA.L KEYR4,AS 3 KEYROW PARAM TABLE IN AS 
MOVE ##11,D0 3 #IPCOM IN DO 
TRAP #1 
CMPI.B #8,D1 3 IS @ PRESSED? 
=~ ALTER BRANCH ADDRESS IN NEXT TWO LINES --~— 
BEQ CLOSE 3 IF PRESSED, QUIT 
BRA.S KEYROW1 ; IF NOT, TEST AGAIN 
KEYROW PARAMETER TABLE 
ALTER LABEL TO .KEYR4 —~-- 
DC.B 9 
DC.B a | 
Dc.L 9 
~-—~ ALTER NEXT PARAMETER TO 6 —-—— 
DC.B 6 


5 READ KEYROW 
3; ONE PARAMETER 
LOWEST FOUR BITS ONLY 


TEST ROW 6 


DC.B 2 3 REPLY OF 8 BITS IN D1 


FETE HE HEE ETE HE HE TE FEE TE TE EEE TERETE HE HEE TEE AE TE FEE EEE HE TE TE EE FEE IEEE TET TE DET TEE HIE IEE HE HE 
“PRIORITY’ 


ALTER LABEL TO .SSAVE —-—— 
MOVEO #$B,DO 3 #MT_PRIOR IN DO 
MOVEQ #-1,D1 3 OF THIS JOB 
MOVEQ #1,D2 3; TO. 
TRAP #1 3 


FFA IEEE HIGHT EEE TEE ETE FERRITE IERIE IEIHE Ri IEIEIE 
"SCREENSAVE * 
ONTO SCREEN 


LABEL TO .MESSi ---~- 
MOVE .L. (A7) , AD 3 CHANNEL ID IN AO 
3 —--~ ALTER LOAD ADDRESS TO MESSAGE1 -—~—— 
LEA.L MESSAGE1,Ai 3 BASE ADDRESS IN Al 
MOVE.W #DO0,A2 3 UT_MTEXT VECTOR IN A2 
JSR (A2) 
3 7777 ALTER BRANCH ADDRESS TO INSTRL ---~ 
BRA.S INSTRL 5 SKIP MESSAGE 
3 —~--- ALTER LENGTH OF STRING AND STRING BYTES —--+~ 
- MESSAGE i BC.wW 44 ; LENGTH OF MESSAGE 
DC.B ‘Name of new screen file’ 
DC.B 10 s CR,LF 
DC.B “(including device): 


FROM KEYBOARD 


LABEL TO INSTRI —-—— 
MOVEG #BUF_LEN,D2 ; LENGTH OF BUFFER IN D2 
MOVE. W #$FFFF,D3 3 INFINITE TIMEOUT 
LEALL BUFFER,A1 ; BASE ADDRESS OF BUFFER IN At 
MOVEO #2,D0 ; #10_FLINE IN DO 
TRAP #3 
LEA.L BUF _POS,Aa0 
SUBQ.L #1,D4 


. INSTR1I 


5 BUF_POS IN AG 
3 SUBTRACT 1 FROM THE D1 REMOVES 
7 THE LF FROM THE STRING COUNT. 
5 PUT NEW STRING LENGTH IN BUF_POS 


» 


MOVE.W D1, (Ad 
TRY TO OPEN A CHANNEL TO THE FILE 


LEA.L 
MOVE 


BUF_POS,AO 
#2,D3 
MOVEQ #-1,D1 
MOVEG #1,D0 
TRAP #2 
TST... DBO 
ALTER BRANCH ADDRESS 70 CONT1 ---— 
BEQ.S CONT : IF NOT, THEN CONTINUE. ELSE:- 


s BUF_POS IN AO 

OPEN NEW EXCLUSIVE FILE 
JOB ID FOR THIS JOB 
#I0_OPEN IN DO 


ERROR? 


IF ERROR, THEN THIS IS USED 
—-—— ALTER BRANCH ADDRESS TO MESS1 ---— 
BRA MESS1 3 60 BACK TO PROMPT 
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to your heart's content, by altering its 
size, shape, position and colours, un- 
til it is exactly what you want. 


Incorporating 


When you are really starting 
to feel confident, you could start trying 
to incorporate the routines into other 
programs. A good candidate for this is 
the program Ellipses from part 8 of 
this series. The simplest way of doing 


| this 


would be to treat the program Ellipses 
as a subroutine of Screensave, so that 
having opened a file to save the 
screen, the program then jumps to the 
routines to plot a pattern of ellipses. 
When a satisfactory pattern is ob- 
tained, the program returns to 
Screensave to save the screen to the 
file. To make sense of the what follows, 
you will need to be familiar with the 
assembler listing for Ellipses. 
Clearly, you would not need 
the whole of the Ellipses program. The 
Jobstart would be redundant, and you 
could use the same console window 
for the prompts and for the ellipses, 
although this is probably not advis- 
able. Similarly, the Endjob would be 
redundant. The Close routine in El- 
lipses to close the console window for 
drawing ellipses would need to end in 
an RTS to return to Screensave. The 
Screensave routine itself would, of 
course, not need the middle section 
concerned with changing priority and 
monitoring the keyboard. Indeed, since 
sleeping in the background will not 
feature in the program, then Priority 
will not be needed. Putting all that 
together, the list of chunks for merg- 
ing should look something like this: 


Jobstart, Console (for text), 
Screensave (first part), Console (for 
ellipses), Cursor, Writemode, Copy, 
Main (for ellipses routine), Fbyte, El- 
lipse, Updownfp, Updownint, 
Updownint, Updownint, Updownint, 
Close (ellipses console), Screensave 
(last part), Close (text console), 
Endjob. 


If you try this, you have to be careful in 
one or two places watching the stack 
pointer to make sure you put the cor- 
rect channel ID into register AO. You 
will also become aware that the pro- 
gramming is becoming just a bit messy 
because the ‘systematic’ bit in the title 
of this series is breaking down. The 
reason for this is quite simple. As long 
as our chunks of code remain short 
and simple they are easy to put to- 
gether without much change. As soon 
as our chunks become longer and more 
complicated, they also become far 
more specific in application, and when 
we want to use themina different way, 
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MACHINE CODE 


IF NO ERROR, THEN THIS CODE IS USED 
---- ALTER LABEL TO .CONT1 --~~ 


.»CONT1 
.MESS2 


3 --—— ALTER 


«MESSAGE2 


3 

3 REDUCE THE 
3 —--- ALTER 
»PRIORL 


MDOVE.L 
MOVE. L 


A0,- (a7) 3 SAVE FILE CHANNEL ED 
4(A7) , AO 3 CHANNEL ID IN AO 
LEA.L MESSAGE? ,AL 3 BASE ADDRESS IN Ai 
MOVE.W $D0,A2 3 UT_MTEXT VECTOR IN AZ 
JSR (AZ) 


BRANCH ADDRESS ¥O PRIORI ——-— 
BRA.S PRIORI 3 SKIP MESSAGE 
DC.W 30 3 LENGTH OF MESSAGE 
pDC.B ‘NOW CREATE SCREEN TO BE SAVED* 
DC.B 190 s CR,LF 


PRIORITY TO t 

LABEL TO .~.PRIOR1 ———- 
MOVEG ##B,DO #MT_PRIOR IN DO 
MOVEQ #-1,D1 ; OF THIS JOB 
MOVE #1,D2 TO t 
TRAP #1 


i 
3 MONITOR THE KEYBOARD FOR <CTRL><SHIFT>X 


3 ---— ALTER 
. KEVYROWS 


---- ALTER 


---- ALTER 


LABEL TO .KEYROWS AND LOAD ADDRESS TO .KEYRS —-—— 
LEA.L KEYRS,AS 3 KEYROW PARAM TABLE IN AS 
MOVEG ##11,D0 3} #IPCOM IN DO 
TRAP #1 
T8 CMPI.B #11,D1 —--—— 
CMPI.B #11,D1 3 IS <CTRLO<SHIFT>X PRESSED? 
BRANCH ADDRESS IN NEXT TWO LINES ———— 
BEQ.S PRIOR2 3 «IF PRESSED, MOVE ON 
BRA.S KEYROWS 3 IF NOT, TEST AGAIN 


KEYROW PARAMETER TABLE 


——--— ALTER 
«KEYRS 


---- ALTER 


LABEL TO .KEYRS ---- 
DC.B sd 
DC.B 1 
DC.L o 

NEXT PARAMETER 7 —-—— 
DcC.B 7 
DC.B Zz 


READ KEYROW 
ONE PARAMETER 
LOWEST FOUR BITS ONLY 


TEST ROW 7 
REPLY OF 8 BITS IN Di 


3 
3 INCREASE PRIORITY BACK TO 32 


«PRIOR2 


MDVEQ #4B,DO #MT_PRIOR IN DO 
MOVE #-1,D1 OF THIS JOB 
MOVES #32,D2 TO 1 


TRAP #1 


3 
5 TRANSFER BYTES FROM FILE TO SCREEN 


«TRA 


MOVE.L 
MOVE.L 
MOVE.W 


(A7)+,AGO 5 FILE CHANNEL ID IN AO 
#$20000,AL 3; START ADDRESS OF SCREEN 
#3FFFF,DS 3; INFINITE TIMEOUT 

MOVE.L #$8000,D2 ; SCREEN SIZE IN D2 

MOVER #49 ,D0 3 FS.SAVE IN DO 

TRAP #3 

MOVER #2,D0 3 #I10_CLOSE IN DO 

TRAP #2 


---- ADD NEXT LINE TO LOOP BACK -—~—-—— 


BRA PRIORITY 


---~ MOVE BUFFER, ETC TO THE END OF THE PROGRAM ———— 
FHI EERIE TH REITER TERETE TEE TE ET HE Hee 


---- ALTER 
SLOAD 


*PRIORITY’ 


LABEL TO .SLOAD --~-- 
MOVEQ #$B,DO #MT_PRIOR IN DO 
MOVEQ #-1,D1 3 OF THIS JOB 
MOVER #1,D2 3 TO 2% 
TRAP #1 : 


FREER EEE EK EEE EEE EEE EEE EI EEE EEE EEE TEETER EE TEETER HEE 


PUT PROMPT 


ALTER 


ALTER 


} ---- ALTER 


} —--- ALTER 
. MESSAGES 


GET STRING 


—-—— ALTER 
INSTR2 


*SCREENLOAD ' 
ONTO SCREEN 


LABEL TO .MESS3 ~--- 
MOVE. L (A7) AD 5 CHANNEL ID IN AO 
LOAD ADDRESS TO MESSAGES ---- 
LEA.L MESSAGES,A1 ; BASE ADDRESS IN Al 
MOVE.W #DO,A2 ; UT_MTEXT VECTOR IN A2 
JSR {A2) 
BRANCH ADDRESS TO INSTR2 -~-- 
BRA.S INSTR2 ; SKIF MESSAGE 
LABEL TO .MESSAGES ---- 
DC.W 4& ; LENGTH OF MESSAGE 
DC.B "Name of saved screen file’ 
DcC.B 10 5 CR,LE 
DC.B "Cincluding device): 


FROM KEYBOARD 


LABEL TO .INSTR? —--- 

MOVED #BUF_LEN,D2 3; LENGTH OF BUFFER IN D2 

MOVE. W #$FFFF,D3 ; INFINITE TIMEOUT 

LEA.L BUFFER,A1 ; BASE ADDRESS OF BUFFER IN Al 

TRAP #3 

LEA.L BUF_POS,AO ; BUF_POS IN AO 

SUBG.L #1,D1i } SUBTRACT 1 FROM THE D1 REMOVES 
THE LF FROM THE STRING COUNT. 


5 
MOVE. Ww D1, (ao) ; PUT NEW STRING LENGTH IN BUF_POS 


47 


it usually means that a slightly differ- 
ent chunk would have suited us better. 


Messy Solution 


Clearly our problem with 
Screensave is in linking the input of a file 
name and opening a file, with actually 
transferring bytes to the file, all in one 
chunk. It works quite nicely if we separate 
the save routine and the screen creation 
routine into different programs, but be- 
comes messy when we try to put them 
together in the same program. 

The only really systematic way 
out of this is to go back to the smaller 
chunks of code and merge them together 
in the way that best suits your purpose. 
As | have already mentioned, all these 
smaller chunks except one have been 
covered in earlier parts of this series. 

The exception is the routine to 
save the screen bytes to a file. This is the 
routine SAVE shown in listing four. Al- 
though we have been using it to save the 
screen ram toa file, itcan be used to save 
any section of ram to a file, 
including data, or programs. It requires 
the channel ID of anew, exclusive channel 
in AQ, the start address to be saved in A1 
and the number of bytes to save in D2. It 
also requires an infinite timeout (-1)in D3. 

Screenload does not present us 
with the same problems. However, it does 
contain a small routine which has not yet 
been shown separately, which you may 
wish to use. This is the Load routine 
shown in listing five. Like Save, it does 
not have to be used to load a file to screen 
ram, but can be use to load any file, data, 
or program, to any part of the ram. 


Ram warning 


Buta word of warning is needed. 
Qdos needs to know what all parts of ram 
are used for, because if it doesn't, it is 
quite likely to suddenly grab some for its 
own use. Also, if you suddenly load a file 
into an area of ram that Qdos has allocated 
for a different purpose, you will almost 
certainly crash the QL. So if you are not 
loading the screen ram, you must make 
sure the ram that is being loaded is prop- 
erly allocated buffer in a program, and is 
big enough to take the whole file. Load 
requires almost exactly the same as Save, 
except that the channel ID in AO must be 
for an old, shared file. 

One final point. Listings one, two 
and three are not supposed to represent 
any optimal or correct way of doing things. 
They are designed to show what is possi- 
ble, and to help understand how certain 
programming problems may be overcome. 
As you become more familiar with the 
various routines in this series, then other, 
shorter, more elegant, solutions will spring 
to mind. But the basic building blocks will 
almost certainly remain the same, and 
listings four and five are two more of those 
basic building blocks. Happy coding. 


TRY TO OPEN A CHANNEL TO THE FILE 


LEA.L 
MOVEQ 


BUF_POS,AO ; BUF_POS IN AG 
#1,D3 OPEN OLD SHARED FILE 
MOVEQ #-1,D4 JOB ID FOR THIS JOB 
MOVEQ #1,D0 #I0_OPEN IN DO 
TRAP #2 
TST.L DO 
BEQ.S GOT_FILE 


; ERROR? 
IF NOT, THEN CONTINUE. ELSE: ~ 


IF ERROR, THEN THIS IS USED 
--+-+- ALTER BRANCH ADDRESS TO MESS3 --—-—— 
BRA MESSS 5 60 BACK TO PROMPT 


IF NO ERROR, THEN THIS CODE IS USED 
TRANSFER BYTES FROM FILE TO SCREEN 


MOVE.L 
MOVE . WwW 
MOVE. 
MOVEG 
TRAP 
MOVES 
TRAP 
----— ADD NEXT LINE TO LOOP BACK ---- 

BRA PRIORITY 
---- DELETE UNWANTED BUFFER ---- 
FEE EIR EE IEE HET REET TET ETE HE 
"CLOSE * 


##20000,A1 
4#$FFFF ,D3 
#$8000,D2 ; 
#£48,D0 


3; START ADDRESS OF SCREEN 
INFINITE TIMEOUT 

SCREEN SIZE IN D2 
FS.LOAD IN DO 


»BGOT_FILE 


#ID_CLOSE IN Do 


CLOSE MOVE.L (A7>+,A0 
MOVED #2,D0 
TRAP #2 

BRA.S END_JOB 
RARITIES IEEE IE IIH IEEE 


“ENDJOB’ 


3 CHANNEL ID IN AG 
3 #I0_CLOSE IN DO 


MOVE. $0A,A2 ; UT_ERRO in AZ 
JSR (A2) 


MOVER #5,D0 
MOVED #-1,D1 
TRAP #1 


#MT_FRJOB IN DO 
ID OF THIS JOB IN Di 


FEE IEE IETF FETE TEETER TE TE FEIT TE FETE FETE TE TE TE IEFE FETE ETE ETE TEE TEE ETE TEE HE 
TO BE POSITIONED AFTER THE CODE 
WE NEED ‘BUFFER’ FOR THE STRING AND “BUF_POS’ FOR THE STRING COUNT 


LENGTH OF INPUT BUFFER 
3 
3 


xeee NOTE *#**#*% BUFFER SHOULD COME LAST OF ALL. 


FEA FE REE IE FETE TE TEETER EE EE EEE FE FE IEE FETE TE HE EE TE EE EE ETE EE TE TE RTE EE TIE 
Listing 4 


HIER TTT EE HET ITE IE TTIIAAHITTET IAI ITER TET TIT TE TEE TEE 
“SAVE * 
KRENEK TEETH ME TEETER ETE ETRE ERIE HEHE 
THIS ROUTINE WILL SAVE A FILE FROM MEMORY. 
Al CONTAINS THE BASE ADDRESS OF THE FILE (MUST BE EVEN) 
D2 CONTAINS THE LENGTH OF THE FILE 
« SAVE MOVE.L (A7) ,AO 3 OR 4(A7),A0 OR BtA7),AO ETC. 
3 CHANNEL ID IN AO 
#$20000,A1 ; BASE ADDRESS OF FILE 
MOVE.L #$9900,D2 ; LENGTH OF FILE 
MOVE.W #$FFFF,DS 3 INFINITE TIMEQUT 
MOVEG #£49,D0 ; FS.SAVE IN DO 
TRAP #3 


MOVE.L 


5 
3 EER EEEEEE EEE EE EERE ERE EEE EREE KE EEEE KE EERE EERRER KEK EHHE EEE ERE EKER EEE EEE 


Listing 5 


FI IIE ETT EH 
"LOAD' 

SEA HE HE EAE FE TE FEE AE EEE EEE IEEE IESE E TFET TER TET TEE EERE EEE ETT T FEE IE 

3 THIS ROUTINE WILL LOAD A FILE TO MEMORY. 

3 Al CONTAINS THE BASE ADDRESS OF THE FILE (MUST BE EVEN) 

3 D2 CONTAINS THE LENGTH OF THE FILE 

3 

«LOAD MOVE.L (A7) ,AO 3 OR 4(A7),A0 OR Bi(A7),AO ETC. 

3 CHANNEL ID IN AO 

#$20000,A1 3; BASE ADDRESS OF FILE 

#$8000,D2 ; LENGTH OF FILE 

MOVE.W #$FFFF,DS 5; INFINITE TIMEOUT 

MOVED #$48,D0 3 FS.LOQAD IN DO 


TRAP #3 


MOVE.L 
MOVE.L 


3 
EE EEE EEE EEE EEE ERE EEE EERE EE EEE REE EE HE EERE EERE RE EEE ER EE EERE EE EE EEE 
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GRAPHICS 


THE PAINTER V4.04 

[F 512K] 100% machine code art and graphics pro- 
gram, by PROGS of Belgium. Multiple screens, can be 
mouse controlled, selection of fonts, patterns, many 
facilities. 


THE CLIPART x 
[F 128K] 3 disks full of clipart pictures, for use with 
most DTP/graphics programs. 


QRACTAL A 
(F 512K] Machine code fractals program. Displays 
Julia or Mandelbrot sets. 


QRACTAL SCREENS 
[F 128K] A disk full of sample screen pictures gener- 
ated with the QRactal program. Buy this to see the 
sample pictures, then ask about a discount when 
buying QRactal itself! 


IMAGE PROCESSOR V2... ee £15.00 
[F 256K] Image enhancement, edge detection, zoom 
and edit, touch up picture generated by digitisers, 
scanners or other graphics programs. Works with 
mode 4 or 8 screens. 

UPGRADE OLD IMAGE PROCESSOR ..........£10.00 
(Send proof of purchase of old version) 


PD2 CLIPART 

[F 128K] Clipart made for PD2 Plus, but available i in 
screen format for use with other DTP/graphics pro- 
grams if required. 


SCREEN SNATCHER . 
[F 1M 128K) ‘Grab’ screen displays from within other 
programs that are not able to save their own displays. 


TEXT ‘N’ GRAPHIX 

[F 256K] NEW! Allows you to insert screens, or part 
of OL screen pictures, into a Quill or plain text file 
printout. Mix NLQ text and graphics in the same 
printout! Currently only for use with 9 pin Epson 
compatible dot matrix printers - ask about a version 
for 24 pin printers due soon. 


(FIM 128K] Translates 9 pin graphics printouts into 
data for a 24 pin printer. 


BIBLE TEXT DISKS, EDITOR FORMAT 

BIBLE TEXT DISKS, QUILL "_DOC” 

[F 256K] Text of the King James Bible on Disk. 
Please state whether you require Editor (plain text) 
or Quill "_doc* format. 


SPELLBOUND 
(F 1M 384K) A spelling checker which can check 
spelling as you type! 30,000 word dictionary 


SPELLBOUND SPECIAL EDITION 

(F 512K) Enganced version of Spellbound with 
50,000 word dictionary & many new features, 
UPGRADE TO SPELLBOUND S.E............ £30.00 


QUICK POSTERS 
(F 2M 128K) Text poster maker, for use with Star 
NL, XB and LC printers. 


ROB ROY BARGAIN PACK ; 
(F 3M 128K) Reviewed in QL WoRId August 1991 


mee 
VISA 
aR 


Dilwyn Jones Computing 


41 Bro Emrys, Tal-y-Bont, 
Bangor, Gwynedd LL57 3YT U.K. 
Tel: Bangor (0248) 354023 


DATA BASES 


ADDRESS BOOK & LABEL PRINTER £15.00 
[F 2M R 384K] Store names and addresses and 
print them out on a variety of label sizes, or print a 
telephone list, etc. 


DATA DESIGN 

[F 512K] Superb, fast 100% machine code 
database by PROGS of Belgium. Programmable via 
BASIC and machine code interfaces - write your 
own database applications in BASIC using the 
DATA Design commands to help you! Runs in 
pointer environment (supplied) 


FLASHBACK 
[F 1M 256K] Fast machine code database which i is 
also very easy to use, 


FLASHBACK SPECIAL EDITION 

[F 2M 512K] Enhanced version of Flashback, new 
commands, report generator, etc 

UPGRADE TO FLASHBACK S.E................... £20.00 
(return Flashback master disk) 


QL GENEALOGIST, STANDARD VERSION... £19.50 
[F 2M 384K] Family trees and family history 
database, one of our best selling programs. 


QL GENEALOGIST SECOND EDITION .......... £30.00 
[F 384K] Enhanced version - for details see our 
advert in QL World December 1991. 

UPGRADE TO SECOND EDITION................. £12.00 
(return Genealogist master disk) 


BUDGET 128K OL GENEALOGIST ...............£12.00 
[F IM 128K] Cut down version for unexpanded 
machines. 


SUPER DISK INDEXER 

F IM 384K] Catalogue your disk collection as a 
database of files. Store it, print it, search & find 
files, make your life easier. 


F 512K] NEW! A database front end for Archive, 
plus a suite of programs called Chaos Busters. 
Software from EMSoft, U.S.A. 


DBPROGS ' 
F 512K] NEW! A collection of Archive utilities and 
text files to help you learn to program Archive. 
Software from EMSoft, U.S.A. 


DTP 


PAGE DESIGNER 2 PLUS 

[F 512K] OL Desktop Publishing program, mix text 
and graphics, make printed pages or posters, use 
clipart, use graphics from other programs etc. 
Prints on most printers. Ask for details! (please 
note: this program has been delayed, apologies to 
those waiting— please check if available before 
ordering) 


UPGRADE PD2 TO PD2 PLUS 
(Send proof of purchase of old PD2) 


QL HARDWARE 


MINI PROCESS CONTROLLER 
Relay switched outputs, controlled via QQL serial 
port. 


SOFTWARE TOOLKIT FOR MPC ABOVE £9.95 
[F 128K] Control the MPC from BASIC programs 
more easily with these extensions. 


NETWORK PROVER 
Plugs between network lead and computer to give 
a visual indication of transmission. 


POSTAGE RATES - SEE BELOW 


OTHER QL SOFTWARE 


PRINTERMASTER 

[F IM 128K] MEW! Tame your printer! Popup utility 
with menu selection of control codes to send to a 
printer, Want to change fonts, set paper length, 
margins, set up for listings or wordprocessing etc. 
without having to refer to the manual and struggle 
with control codes, Let Printermaster take the 
strain out of living with your printer. 


HOME BUDGET 
[F IM 128K} Domestic bills and accounts program, 
plus a UK Income Tax Calculator. 


REMIND-ME ... . las £12.00 
[F IM 128K] Dates and events reminder program - 
remember about birthdays, licence renewals, etc. 
Quick and very easy to use. 


REMIND-ME PLUS A 
(F1M 128k) NEW! Enhanced version with ability to 
schedule twice as many dates, longer event 
descriptions, etc. 

UPGRADE REMIND-ME TO REMIND-ME PLUS ...£10.00 
Return master disk with order for upgrade 


SCREEN ECONOMISER 
(FIM 128K] Turns off the QL display after a set 
number of minutes to protect the screen. 


SLOWGOLD .. sigaj £5.00 
[F 128K] Slowdown routine and control panel for 
software which runs too fast on Gold Card or 
indeed any QL system. 


TASKMASTER .. . £25.00 
{FIM 384K} Task switching utility, ‘Enables you to 
conveniently switch between several programs in 
memory. Calculator, notepad and file handling 
utility included. 


SUPER DISK LABELLER 

(F 256K] Print neat labels for your floppy disks 
listing the filenames on the disk in columns in 
small print. 


THE CAT 

[F IM 128K] List files on a disk or cartridge to the 
screen, or print on paper, in columns (optionally 
sorted in this latest version). Useful and convenient 
utility. 


%& SEE ALSO THE OTHER HALF OF THIS ADVERT ON THE PRECEDING PAGE x 


for airmail pastage where possible. 


PAYMENT:We can accept payment by cash, cheque (in UK Pounds Sterling only, drawn on UK branch of bank or building society), Postal Order, International EUROCA 


SOFTWARE POSTAGE: Software sent post-free to UK addresses. Abroad add £1.00 per program for postage and packing. 
SUPPLIES POSTAGE: For disks, boxes and stands, add £2.50 for postage to UK addresses, or 10% of order value {minimum postage £3.50) < 


RD 


Postal/Money order, or Eurocheque, We can also accept payment by these credit cards: VISA, ACCESS. MASTERCARD, EUROCARD and also Barclays 


Remember to sign your order. Goods remain property of DJC until paid for in full. Our telephone number above has an answering machine for when we are 


CONNECT card. Please state your card type, number, expiry date and your address (goods paid for by credit card can only be sent to cardholder's address}. 


unable to answer in person — don't be shy! 


